Launcher3 项目使用指南

Launcher3 项目使用指南

Launcher3 The Launcher3 fork known as "Rootless Pixel Launcher" 项目地址: https://gitcode.com/gh_mirrors/la/Launcher3

1. 项目目录结构及介绍

Launcher3 项目目录结构如下：

.
├── assets
├── go
├── proto_overrides
├── proto_pixel
├── protos
├── res
├── src
│   ├── src_config
│   ├── src_flags
│   └── tests
├── .gitignore
├── Android.mk
├── AndroidManifest-common.xml
├── AndroidManifest.xml
├── CleanSpec.mk
├── LICENSE
├── MODULE_LICENSE_APACHE2
├── README.md
├── build.gradle
├── fill_screens.py
├── print_db.py
├── proguard.flags
└── ...

• assets/: 存储项目所需的资源文件。
• go/: 与项目启动相关的脚本和文件。
• proto_overrides/: 包含协议覆盖文件的目录。
• proto_pixel/: 包含 Pixel 相关协议文件的目录。
• protos/: 包含项目使用的协议缓冲区文件。
• res/: 存储项目的资源文件，如布局文件、图片等。
• src/: 源代码目录，包含应用的主要逻辑。
  • src_config/: 包含配置相关的代码。
  • src_flags/: 包含应用标志的配置。
  • tests/: 包含单元测试的代码。
• Android.mk: Android 构建脚本。
• AndroidManifest-common.xml: 应用通用配置文件。
• AndroidManifest.xml: 应用主配置文件。
• CleanSpec.mk: 清理构建文件的脚本。
• LICENSE: 项目许可证文件。
• MODULE_LICENSE_APACHE2: Apache 2.0 许可证文件。
• README.md: 项目说明文件。
• build.gradle: 项目构建脚本。
• fill_screens.py: Python 脚本，用于填充屏幕。
• print_db.py: Python 脚本，用于打印数据库信息。
• proguard.flags: ProGuard 配置文件。

2. 项目的启动文件介绍

项目的启动文件主要是 AndroidManifest.xml，此文件定义了应用的基本信息和启动组件。

<manifest ... >
  <application
    ... >
    <activity
      android:name=".MainActivity"
      android:label="@string/app_name"
      android:icon="@drawable/ic_launcher">
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
    </activity>
    ...
  </application>
</manifest>

这里定义了应用的启动活动 MainActivity，它是用户打开应用时首先看到的界面。

3. 项目的配置文件介绍

项目的配置文件主要包括 AndroidManifest.xml 中的 <application> 标签内的配置和 build.gradle 文件。

• AndroidManifest.xml 中的配置定义了应用的名称、图标、主题等属性，以及应用的各种组件。

<application
  android:allowBackup="true"
  android:icon="@drawable/ic_launcher"
  android:label="@string/app_name"
  android:theme="@style/AppTheme" >
  ...
</application>

• build.gradle 文件包含了项目的构建配置，如依赖管理、构建类型、编译选项等。

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    buildToolsVersion "30.0.2"

    defaultConfig {
        applicationId "com.example.launcher3"
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    ...
}

在这里，我们定义了应用的 ID、支持的最低和目标 SDK 版本，以及应用的版本代码和名称。

Launcher3 The Launcher3 fork known as "Rootless Pixel Launcher" 项目地址: https://gitcode.com/gh_mirrors/la/Launcher3