Zotero for Android 项目使用与配置指南

1. 项目目录结构及介绍

Zotero for Android 是一个开源项目，其目录结构如下：

• app/: 包含了 Android 应用的主要代码，包括 Java/Kotlin 源文件、资源文件、布局文件等。
• buildSrc/: 包含了自定义的 Gradle 插件和依赖。
• gradle/: 包含了 Gradle 脚本，用于构建项目。
• pdf-worker/: 实现了与 PDF 文件处理相关的功能。
• scripts/: 包含了用于项目构建或管理的脚本文件。
• translation/: 包含了项目所需的翻译文件。
• .github/: 包含了 GitHub 工作流文件和模板。
• CONTRIBUTING.md: 提供了贡献指南。
• COPYING: 包含了项目的许可证信息，即 GNU Affero General Public License。
• build.gradle.kts: 主 Gradle 构建脚本。
• debug.keystore: Android 应用调试的密钥库文件。
• gradle.properties: Gradle 全局属性配置文件。
• gradlew 和 gradlew.bat: Gradle 命令行工具的脚本文件。
• settings.gradle.kts: Gradle 设置文件。

2. 项目的启动文件介绍

项目的启动文件通常是位于 app/src/main/java/<your_package_name>/MainActivity.java 或 MainActivity.kt。这个文件是 Android 应用的入口点，其中包含了创建应用界面和处理用户交互的逻辑。

// 示例代码，非实际项目代码
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 初始化界面组件和事件监听
    }
}

3. 项目的配置文件介绍

项目的配置文件主要指的是 build.gradle.kts 和 gradle.properties。

• build.gradle.kts: 此文件定义了项目的构建逻辑，包括依赖管理、构建类型、签名配置等。

// 示例代码，非实际项目代码
plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion <version>
    defaultConfig {
        applicationId "<your_package_name>"
        minSdkVersion <version>
        targetSdkVersion <version>
        versionCode <version>
        versionName "<version>"
    }
    // 其他配置
}

dependencies {
    // 添加项目依赖
}

• gradle.properties: 此文件包含了一些全局的 Gradle 属性设置，如 JVM 参数、项目构建选项等。

# 示例配置，非实际项目配置
org.gradle.jvmargs=-Xmx1536m
android.useAndroidX=true

确保在开始之前，你已经根据项目需求和开发环境正确配置了这些文件。