poi-android 开源项目教程

poi-android 开源项目教程

1. 项目的目录结构及介绍

poi-android/
├── app/
│   ├── build.gradle
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/
│   │   │   │       └── example/
│   │   │   │           └── poiandroid/
│   │   │   │               ├── MainActivity.kt
│   │   │   │               └── ...
│   │   │   ├── res/
│   │   │   │   ├── drawable/
│   │   │   │   ├── layout/
│   │   │   │   ├── mipmap/
│   │   │   │   └── values/
│   │   │   └── AndroidManifest.xml
│   └── ...
├── build.gradle
├── settings.gradle
└── ...

• app/: 主应用程序模块。
  • build.gradle: 应用程序的构建脚本。
  • src/main/: 主源代码目录。
    • java/com/example/poiandroid/: 包含主要的 Kotlin 源文件。
      • MainActivity.kt: 应用程序的主活动。
    • res/: 资源文件目录，包括布局、图片和字符串等。
    • AndroidManifest.xml: 应用程序的清单文件。
• build.gradle: 项目的根构建脚本。
• settings.gradle: 项目的设置文件。

2. 项目的启动文件介绍

MainActivity.kt 是 poi-android 项目的主启动文件。它继承自 AppCompatActivity 并负责应用程序的初始界面显示。

package com.example.poiandroid

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }
}

• onCreate(savedInstanceState: Bundle?): 活动创建时调用的方法，设置布局文件 activity_main。

3. 项目的配置文件介绍

AndroidManifest.xml

AndroidManifest.xml 文件位于 app/src/main/ 目录下，是 Android 应用程序的配置文件，包含应用程序的基本信息和组件声明。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.poiandroid">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

• <application>: 定义应用程序的属性，如图标、标签和主题。
• <activity>: 声明活动组件，MainActivity 是主活动。
• <intent-filter>: 指定活动为应用程序的入口点。

build.gradle

build.gradle 文件位于项目根目录和 app/ 目录下，分别负责项目和应用程序模块的构建配置。

根目录下的 build.gradle:

// 项目级别的构建脚本
buildscript {
    ext.kotlin_version = '1.5.21'
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.2.2"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

app/ 目录下的 build.gradle:

//