Polaris 开源项目教程

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

Polaris 项目的目录结构如下：

Polaris/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/
│   │   │   │       └── cyrilmottier/
│   │   │   │           └── polaris/
│   │   │   └── res/
│   │   │       ├── drawable/
│   │   │       ├── layout/
│   │   │       ├── menu/
│   │   │       ├── values/
│   │   │       └── ...
│   ├── build.gradle
│   └── ...
├── build.gradle
├── gradle.properties
├── settings.gradle
└── ...

目录结构介绍

• app/：应用程序的主要目录。
  • src/：源代码目录。
    • main/：主源代码目录。
      • java/：Java 源代码目录。
        • com/cyrilmottier/polaris/：具体包路径，包含项目的 Java 类文件。
      • res/：资源文件目录。
        • drawable/：可绘制资源目录。
        • layout/：布局文件目录。
        • menu/：菜单文件目录。
        • values/：值资源目录，如字符串、颜色等。
  • build.gradle：模块级构建脚本。
• build.gradle：项目级构建脚本。
• gradle.properties：Gradle 配置属性文件。
• settings.gradle：项目设置文件。

2. 项目的启动文件介绍

项目的启动文件位于 app/src/main/java/com/cyrilmottier/polaris/ 目录下，通常是 MainActivity.java。

MainActivity.java

package com.cyrilmottier.polaris;

import android.app.Activity;
import android.os.Bundle;

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

启动文件介绍

• MainActivity.java：应用程序的主活动，负责初始化用户界面和处理用户交互。
• onCreate 方法：在活动创建时调用，设置布局文件 activity_main。

3. 项目的配置文件介绍

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

build.gradle

项目级 build.gradle

// 项目级 build.gradle
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.0'
    }
}

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

模块级 build.gradle

// 模块级 build.gradle
apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.cyrilmottier.polaris"
        minSdkVersion 16
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.3.1'
    implementation 'com.google.android.material:material:1.4.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.0'
}

gradle.properties

# Gradle 配置属性
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
android.useAndroidX=true
android.nonTransitiveRClass=true

配置文件介绍