PocketHub Android 应用项目教程

PocketHub Android 应用项目教程

1. 项目目录结构及介绍

PocketHub Android 应用项目的目录结构如下：

PocketHub/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   ├── res/
│   │   │   └── AndroidManifest.xml
│   ├── build.gradle
│   └── proguard-rules.pro
├── gradle/
│   └── wrapper/
├── script/
├── style/
├── .gitattributes
├── .gitignore
├── .travis.yml
├── CONTRIBUTING.md
├── ISSUE_TEMPLATE.md
├── LICENSE
├── README.md
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle

目录结构介绍

• app/: 包含应用的主要代码和资源文件。

  • src/main/: 包含应用的主要源代码和资源。
    • java/: 包含应用的 Java 源代码。
    • res/: 包含应用的资源文件，如布局、图片、字符串等。
    • AndroidManifest.xml: 应用的清单文件，定义应用的组件、权限等。
  • build.gradle: 应用模块的构建脚本。
  • proguard-rules.pro: ProGuard 配置文件，用于代码混淆。

• gradle/: 包含 Gradle 构建系统的包装器。

  • wrapper/: 包含 Gradle 包装器的配置文件。

• script/: 包含项目的脚本文件。

• style/: 包含项目的样式文件。

• .gitattributes: Git 属性配置文件。

• .gitignore: Git 忽略文件配置。

• .travis.yml: Travis CI 配置文件。

• CONTRIBUTING.md: 贡献指南文件。

• ISSUE_TEMPLATE.md: 问题模板文件。

• LICENSE: 项目许可证文件。

• README.md: 项目说明文件。

• build.gradle: 项目的根构建脚本。

• gradle.properties: Gradle 属性配置文件。

• gradlew: Gradle 包装器脚本。

• gradlew.bat: Gradle 包装器脚本的 Windows 版本。

• settings.gradle: 项目设置文件。

2. 项目的启动文件介绍

PocketHub Android 应用的启动文件是 app/src/main/java/ 目录下的主 Activity 文件。通常，Android 应用的启动文件是 AndroidManifest.xml 中指定的主 Activity。

例如，如果主 Activity 是 MainActivity.java，则启动文件如下：

package com.pockethub.android;

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

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

启动文件介绍

• MainActivity.java: 这是应用的主 Activity，负责启动应用并加载主界面。
• onCreate(): 这是 Activity 的生命周期方法，在 Activity 创建时调用，通常用于初始化界面和数据。

3. 项目的配置文件介绍

3.1 build.gradle

build.gradle 文件是 Gradle 构建系统的配置文件，分为项目级别的 build.gradle 和模块级别的 build.gradle。

项目级别的 build.gradle

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

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

模块级别的 build.gradle

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

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.pockethub.android"
        minSdkVersion 21
        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'
}

3.2 gradle.properties

gradle.properties 文件用于配置 Gradle 构建系统的属性。

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

3.3 AndroidManifest.xml

AndroidManifest.xml 文件是 Android 应用的清单文件，定义了应用的组件、权限、启动 Activity 等。

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

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

3.4 proguard-rules.pro

proguard-rules.pro 文件用于配置 ProGuard 混淆规则。

# ProGuard 配置
-keep class com.pockethub.android.** { *; }
-dontwarn com.pockethub.android.**

以上是 PocketHub Android 应用项目的主要配置文件介绍。