Android Studio用户指南（管理项目）

1.

Android 项目视图

要查看项目的实际文件结构（包括 Android 视图下隐藏的所有文件），请从 Project 窗口顶部的下拉菜单中选择 Project。

选择 Project 视图后，您会看到更多文件和目录。最重要的一些文件和目录如下所示：

模块名称/

build/

包含构建输出。

libs/

包含私有库。

src/

包含模块的所有代码和资源文件，分为以下子目录：

androidTest/

包含在 Android 设备上运行的仪器测试的代码。如需了解详细信息，请参阅 Android 测试文档。

main/

包含“主”源集文件：所有构建变体共享的 Android 代码和资源（其他构建变体的文件位于同级目录中，例如调试构建类型的文件位于 src/debug/ 中）。

AndroidManifest.xml

说明应用及其每个组件的性质。如需了解详细信息，请参阅 AndroidManifest.xml 文档。

java/

包含 Java 代码源。

jni/

包含使用 Java 原生接口 (JNI) 的原生代码。如需了解详细信息，请参阅 Android NDK 文档。

gen/

包含 Android Studio 生成的 Java 文件，例如您的 R.java 文件以及从 AIDL 文件创建的接口。

res/

包含应用资源，例如可绘制对象文件、布局文件和 UI 字符串。如需了解详细信息，请参阅应用资源。

assets/

包含应原封不动地编译到 .apk 文件中的文件。您可以使用 URI 像浏览典型文件系统一样浏览此目录，以及使用 AssetManager 以字节流形式读取文件。例如，此位置非常适合纹理和游戏数据。

test/

包含在您的主机 JVM 上运行的本地测试的代码。

build.gradle（模块）

定义模块特定的构建配置。

build.gradle（项目）

定义适用于所有模块的构建配置。此文件已集成到项目中，因此您应当在所有其他源代码的修订控制中保留这个文件。

如需了解有关其他构建文件的信息，请参阅配置构建。

2.

项目结构设置

要更改 Android Studio 项目的各种设置，请点击 File > Project Structure，打开 Project Structure 对话框。此对话框包含以下部分：

• SDK Location：设置您的项目使用的 JDK、Android SDK 和 Android NDK 的位置。
• Project：设置 Gradle 和 Android Plugin for Gradle 的版本，以及存储区位置名称。
• Developer Services：包含 Google 或其他第三方的 Android Studio 附加组件的设置。请参阅下面的 Developer Services。
• Modules：允许您编辑模块特定的构建配置，包括目标和最低 SDK、应用签名和库依赖项。请参阅下面的 Modules。

  Modules

• 借助 Modules 设置部分，您可以为项目的每个模块更改配置选项。每个模块的配置页面分成以下标签：

• Properties：指定编译模块所用的 SDK 和构建工具的版本。
• Signing：指定用于签署您的 APK 的证书。
• Flavors：允许您创建多个构建风味，其中每个风味指定一组配置设置，例如模块的最低和目标 SDK 版本，以及版本代码和版本名称。例如，您可以定义一个最低 SDK 为 15、目标 SDK 为 21 的风味，以及另一个最低 SDK 为 19、目标 SDK 为 23 的风味。
• Build Types：允许您创建和修改构建配置，如配置 Gradle 构建中所述。默认情况下，每个模块都有调试和发布构建类型，不过您可以根据需要定义更多类型。
• Dependencies：列出此模块的库、文件和模块依赖项。您可以通过此窗格添加、修改和删除依赖项。如需了解有关模块依赖项的详细信息，请参阅配置 Gradle 构建。

3.

创建库模块

要在您的项目中创建一个新的库模块，请按以下步骤操作：

1. 点击 File > New > New Module。
2. 在出现的 Create New Module 窗口中，依次点击 Android Library 和 Next。

   还存在一个用于创建 Java 库的选项，可以构建传统的 JAR 文件。尽管 JAR 文件在大多数项目中都非常实用（尤其在您希望与其他平台共享代码时），但这种文件不允许您包含 Android 资源或清单文件，而后者对于 Android 项目中的代码重用非常有用。因此，本指南将侧重论述创建 Android 库。

3. 为您的库命名，并为库中代码选择一个最低的 SDK 版本，然后点击 Finish。

在 Gradle 项目同步完成后，库模块将显示左侧的 Project 面板中。如果您未看到新模块文件夹，请确保将视图切换为 Android 视图。

将应用模块转换为库模块

如果您现有的应用模块包含您希望重用的所有代码，则可以按照以下步骤将其转换为库模块：

1. 打开现有应用模块的 build.gradle 文件。您应在顶部看到以下内容：
   apply plugin: 'com.android.application'
2. 按照下面所示更改插件分配：

    

   apply plugin: 'com.android.library'
3. 点击 Sync Project with Gradle Files。

就这么简单。模块的整个结构仍然相同，但是现在它将作为 Android 库运行，构建也将创建一个 AAR 文件，而不是 APK。

以依赖项形式添加您的库

要在另一个应用模块中使用您的 Android 库的代码，请按以下步骤操作：

1. 通过两种方式之一将库添加到您的项目（如果您是在相同项目中创建的库模块，则该模块已经存在，您可以跳过此步骤）：
   • 添加已编译的 AAR（或 JAR）文件：
     1. 点击 File > New Module。
     2. 依次点击 Import .JAR/.AAR Package 和 Next。
     3. 输入 AAR 或 JAR 文件的位置，然后点击 Finish。
   • 将库模块导入到您的项目中：
     1. 点击 File > New > Import Module。
     2. 输入库模块目录的位置，然后点击 Finish。

     库模块将复制到您的项目中，因此您可以尽管编辑库代码。如果您希望维护一个版本的库代码，则此方法可能不是您想要的，您应按照上文所述导入编译的 AAR 文件。

2. 确保库列在您 settings.gradle 文件的顶部，如下面名为“my-library-module”的库所示：
   include ':app', ':my-library-module'
3. 打开应用模块的 build.gradle 文件，并向 dependencies 块中添加一行新代码，如下面的片段所示：
   dependencies {
       compile project(":my-library-module")
   }
4. 点击 Sync Project with Gradle Files。

在上面的示例中，名为 my-library- module 的 Android 库模块成为 build.gradle 文件所在模块的构建依赖项。

您的应用模块现在可以访问 Android 库中的任何代码和资源，库 AAR 文件在构建时已捆绑到您的 APK 中。

不过，如果希望单独共享 AAR 文件，则可以在 项目名称/模块名称/build/outputs/aar/ 中找到它，也可以通过点击 Build > Make Project 的方式重新生成此文件。