Mango 开源项目安装与使用指南

1. 目录结构及介绍

Mango 是一个基于 Kotlin 实现的 Android 应用程序，专为 Dribbble 社区设计。以下是其主要的目录结构及其简要说明：

.
├── app                 # 主应用模块，包含了所有的Activity、Fragment以及相关UI组件
│   ├── src              # 源代码目录
│       ├── main         # 主工程目录，包括java、res等资源
│           ├── java     # Java源码文件夹，但此项目实际完全采用Kotlin
│               └── com.example... # 包含所有Kotlin源代码
│           └── res      # 资源文件夹，如布局文件、图片等
│   ├── build.gradle    # 应用模块构建脚本
│   └── ...              # 其他Gradle相关或辅助文件
├── .gitignore          # Git忽略文件列表
├── travis.yml          # Travis CI 的配置文件
├── LICENSE             # 许可证文件，采用MIT许可证
├── README.md           # 项目简介和快速入门指南
├── build.gradle        # 顶层构建脚本
├── gradle.properties   # Gradle属性文件
├── gradlew             # Gradle Wrapper 脚本（Linux/macOS）
├── gradlew.bat         # Gradle Wrapper 脚本（Windows）
└── settings.gradle     # 设置文件，用于指定项目结构或库依赖

# 注意：mango.properties是配置文件的一部分，但不直接提交到Git，需手动创建

2. 项目的启动文件介绍

在 app/src/main/java/com/example/yourpackage 目录下，通常会有一个或多个启动Activity。虽然具体名称未直接提供，但通常情况下，应用程序的入口点是一个名为 MainActivity 或类似的类，该类通过AndroidManifest.xml中的 <intent-filter> 标签被标记为启动活动。

// 假设的启动Activity示例（不存在于引用中，仅做说明）
package com.example.mango

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

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // 初始化逻辑等...
    }
}

3. 项目的配置文件介绍

build.gradle (Module: app)

位于每个模块下的 build.gradle 文件控制着该模块的构建配置，例如依赖关系、编译选项等。示例如下：

apply plugin: 'com.android.application'

android {
    compileSdkVersion XX // 版本号
    defaultConfig {
        applicationId "com.example.mango"
        minSdkVersion YY // 最小支持版本
        targetSdkVersion ZZ // 靶向版本
        versionCode AA
        versionName "BB.BB"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:XX.YY.ZZ'
    // 其他项目依赖
}

mango.properties

这是一个应该手动创建的私有配置文件，用于存放敏感信息，如Dribbble API的客户端ID、密钥等，但它并未直接托管在仓库中。

CLIENT_ID=YOUR_CLIENT_ID
CLIENT_SECRET=YOUR_CLIENT_SECRET
VERIFICATION_TOKEN=YOUR_VERIFICATION_TOKEN

请注意，为了保护这些机密数据，不应将其添加到版本控制系统中。

AndroidManifest.xml

虽然不是直接提到的配置文件，但它是定义应用程序元数据、权限、主Activity和其他组件的关键文件。它同样指定哪些Activity可以作为启动Activity。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.mango">
    
    <application>
        <!-- 启动Activity -->
        <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>

以上就是Mango项目的基本结构、启动文件和核心配置文件的概览，希望这能帮助你快速了解并开始使用这个项目。