MosMetro 安卓客户端开发指南

1. 项目目录结构及介绍

MosMetro-Android项目遵循标准的Android应用结构，其主要目录结构如下：

mosmetro-android/
|-- app                             # 主应用模块
|   |-- src                           # 源代码目录
|   |   |-- main                        # 应用的主要源码
|   |   |   |-- java                     # Java源代码，包括主Activity和其他业务逻辑类
|   |   |   |--- com.mosmetro.android... # 包含应用的核心业务类
|   |   |   |-- res                      # 资源文件夹，包括布局、图片、字符串等资源
|   |   |       |-- drawable...
|   |   |       |-- layout...
|   |   |       |-- values...
|   |   |-- androidTest                  # 单元测试和UI测试
|   |   |-- test                         # JUnit测试代码
|   |-- build.gradle                   # 应用模块构建脚本
|   |-- proguard-rules.pro              # ProGuard混淆规则
|-- .gitignore                       # Git忽略文件列表
|-- README.md                         # 项目说明文档
|-- build.gradle                      # 项目级构建脚本
|-- gradle.properties                 # Gradle属性设置

目录结构简介:

• app: 应用程序的核心部分，包含了所有业务逻辑、界面以及相关资源。
• src/main/java: 存放所有的Java源代码文件，这里是应用逻辑实现的地方。
• src/main/res: 包含应用的所有静态资源，如布局文件(.xml)、图标(.png)和字符串资源等。
• build.gradle 和 build.gradle (在app目录下): 分别是项目和模块级别的Gradle构建脚本，定义了依赖项、编译规则等。
• .gitignore: 控制哪些文件不应该被Git版本控制系统跟踪。

2. 项目的启动文件介绍

启动文件通常位于src/main/java/com/mosmetro/android/包路径下（具体路径可能会依据实际项目有所不同）。主活动（MainActivity）是最关键的启动点，负责初始化应用界面和核心功能，它继承自Android的Activity类。例如：

package com.mosmetro.android;

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

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main); // 设置主布局
        // 初始化应用逻辑
    }
}

在这段代码中，setContentView(R.layout.activity_main)是加载应用的初始布局文件，这是用户首先看到的界面。

3. 项目的配置文件介绍

build.gradle (Module: app)

此文件配置了应用模块的构建信息，包括依赖库、编译选项等。示例片段可能包括：

apply plugin: 'com.android.application'

android {
    compileSdkVersion XX     // 编译SDK版本
    defaultConfig {           // 默认配置
        applicationId "ru.mosmetro.metro"
        minSdkVersion 21       // 最低支持的Android SDK版本
        targetSdkVersion XX    // 目标SDK版本
        versionCode XX         // 版本号
        versionName "XX.XX"    // 版本名称
        ...
    }

    buildTypes {             // 构建类型
        release {
            minifyEnabled true/false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    dependencies {           // 项目依赖
        implementation 'com.android.support:appcompat-v7:XX.X.X'
        // 更多依赖...
    }
}

res/values/strings.xml

包含应用中的字符串资源，用于国际化和支持动态文本。示例：

<resources>
    <string name="app_name">MosMetro</string>
    <!-- 其他应用内使用的字符串 -->
</resources>

以上是对MosMetro安卓客户端项目的基本架构、启动流程和配置文件的概览。请注意，具体文件路径和内容应以实际项目仓库为准。开发者在接入新特性或进行维护时，需详细阅读项目内部文档和各文件注释，确保对项目有全面理解。