开源项目 Cyclestreets Android 应用教程

开源项目 Cyclestreets Android 应用教程

androidThe Android app brings CycleStreets routing and turn-by-turn live navigation to your phone.项目地址:https://gitcode.com/gh_mirrors/android27/android

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

Cyclestreets Android 应用的目录结构如下：

android/
├── app/
│   ├── build/
│   ├── libs/
│   ├── src/
│   │   ├── main/
│   │   │   ├── assets/
│   │   │   ├── java/
│   │   │   │   └── net/
│   │   │   │       └── cyclestreets/
│   │   │   ├── res/
│   │   │   └── AndroidManifest.xml
│   │   ├── test/
│   │   └── androidTest/
│   ├── build.gradle
│   └── proguard-rules.pro
├── gradle/
├── .gitignore
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── README.md
└── settings.gradle

目录结构介绍

• app/: 包含应用的主要代码和资源文件。
  • build/: 编译生成的文件。
  • libs/: 第三方库文件。
  • src/: 源代码文件。
    • main/: 主代码和资源。
      • assets/: 应用的静态资源文件。
      • java/: Java 源代码文件。
        • net/cyclestreets/: 应用的主要代码。
      • res/: 应用的资源文件，如布局、图片等。
      • AndroidManifest.xml: 应用的配置文件。
    • test/: 单元测试代码。
    • androidTest/: 集成测试代码。
  • build.gradle: 应用的构建脚本。
  • proguard-rules.pro: ProGuard 配置文件。
• gradle/: Gradle 相关的文件。
• .gitignore: Git 忽略文件配置。
• build.gradle: 项目的构建脚本。
• gradle.properties: Gradle 属性配置。
• gradlew 和 gradlew.bat: Gradle 包装器脚本。
• README.md: 项目说明文档。
• settings.gradle: 项目设置文件。

2. 项目的启动文件介绍

项目的启动文件是 AndroidManifest.xml，位于 app/src/main/ 目录下。这个文件包含了应用的基本信息和组件声明。

AndroidManifest.xml 主要内容

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

    <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 是应用的启动活动。
• <intent-filter>: 定义了启动活动的意图过滤器，使得应用可以在启动器中显示。

3. 项目的配置文件介绍

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

build.gradle

build.gradle 文件位于项目根目录和 app/ 目录下，分别用于配置整个项目和应用模块。

根目录下的 build.gradle

// 项目级别的构建脚本
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.0'
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()

androidThe Android app brings CycleStreets routing and turn-by-turn live navigation to your phone.项目地址:https://gitcode.com/gh_mirrors/android27/android