StreetComplete 项目教程

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

StreetComplete 项目的目录结构如下：

StreetComplete/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── assets/
│   │   │   ├── java/
│   │   │   │   ├── de/
│   │   │   │   │   ├── westnordost/
│   │   │   │   │   │   ├── streetcomplete/
│   │   │   │   │   │   │   ├── data/
│   │   │   │   │   │   │   ├── quests/
│   │   │   │   │   │   │   ├── view/
│   │   │   │   │   │   │   ├── ...
│   │   │   ├── res/
│   │   │   ├── AndroidManifest.xml
│   ├── build.gradle.kts
├── build.gradle.kts
├── settings.gradle.kts
├── README.md

目录结构介绍

• app/: 包含应用程序的主要代码和资源。
  • src/: 源代码目录。
    • main/: 主要源代码和资源。
      • assets/: 应用程序的静态资源文件。
      • java/: Java 源代码目录。
        • de/westnordost/streetcomplete/: 主要应用程序包。
          • data/: 数据处理相关代码。
          • quests/: 任务处理相关代码。
          • view/: 视图相关代码。
          • ...
      • res/: 应用程序的资源文件（如布局、字符串、图片等）。
      • AndroidManifest.xml: 应用程序的清单文件。
  • build.gradle.kts: 应用程序的构建脚本。
• build.gradle.kts: 项目的根构建脚本。
• settings.gradle.kts: 项目的设置脚本。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

StreetComplete 项目的启动文件是 AndroidManifest.xml，位于 app/src/main/ 目录下。

AndroidManifest.xml

AndroidManifest.xml 是 Android 应用程序的清单文件，包含了应用程序的基本信息和配置，如应用程序的包名、权限、启动 Activity 等。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="de.westnordost.streetcomplete">

    <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>

启动文件介绍

• <manifest>: 根元素，定义了应用程序的包名。
• <application>: 应用程序的配置，包括图标、标签、主题等。
• <activity>: 定义了应用程序的 Activity，其中 MainActivity 是应用程序的启动 Activity。
• <intent-filter>: 定义了启动 Activity 的意图过滤器，使得系统能够识别并启动该 Activity。

3. 项目的配置文件介绍

StreetComplete 项目的配置文件主要包括 build.gradle.kts 和 settings.gradle.kts。

build.gradle.kts

build.gradle.kts 是项目的构建脚本，位于项目根目录和 app/ 目录下。

根目录下的 build.gradle.kts

plugins {
    id("com.android.application") version "7.0.0" apply false
    id("com.android.library") version "7.0.0" apply false
    id("org.jetbrains.kotlin.android") version "1.5.21" apply false
}

all