Google Cardboard Java 项目教程

1. 项目目录结构及介绍

Google Cardboard Java 项目的目录结构如下：

cardboard-java/
├── apks/
├── assets/
├── gradle/
│   └── wrapper/
├── libraries/
├── samples/
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── build.gradle
├── gradlew
├── gradlew.bat
├── proguard-gvr.txt
└── settings.gradle

目录介绍

• apks/: 存放生成的 APK 文件。
• assets/: 存放项目所需的资源文件，如图片、音频等。
• gradle/wrapper/: 包含 Gradle Wrapper 的相关文件，用于确保项目使用特定版本的 Gradle。
• libraries/: 存放项目依赖的库文件。
• samples/: 包含示例代码，展示了如何使用 Google Cardboard SDK。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被 Git 管理。
• CONTRIBUTING.md: 贡献指南，说明如何为项目贡献代码。
• LICENSE: 项目的开源许可证。
• README.md: 项目说明文件，包含项目的基本信息和使用指南。
• build.gradle: 项目的构建脚本，定义了项目的依赖和构建配置。
• gradlew: Gradle Wrapper 的 Unix/Linux 启动脚本。
• gradlew.bat: Gradle Wrapper 的 Windows 启动脚本。
• proguard-gvr.txt: ProGuard 配置文件，用于代码混淆。
• settings.gradle: 项目的设置文件，定义了项目的模块和依赖关系。

2. 项目启动文件介绍

项目的启动文件通常位于 samples/ 目录下，具体文件取决于示例项目的结构。以下是一个典型的启动文件路径：

samples/app/src/main/java/com/google/vr/sdk/samples/app/MainActivity.java

启动文件介绍

• MainActivity.java: 这是示例应用的主活动文件，通常是应用启动时首先加载的类。它包含了应用的主要逻辑和界面初始化代码。

3. 项目配置文件介绍

build.gradle

build.gradle 是项目的构建配置文件，定义了项目的依赖、插件和其他构建相关配置。以下是一个典型的 build.gradle 文件内容：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.google.vr.sdk.samples.app"
        minSdkVersion 19
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.google.vr:sdk-base:1.190.0'
}

settings.gradle

settings.gradle 是项目的设置文件，定义了项目的模块和依赖关系。以下是一个典型的 settings.gradle 文件内容：

include ':app'

proguard-gvr.txt

proguard-gvr.txt 是 ProGuard 配置文件，用于代码混淆。以下是一个典型的 proguard-gvr.txt 文件内容：

-keep class com.google.vr.sdk.** { *; }
-keep class com.google.vr.cardboard.** { *; }

这些配置文件确保了项目的正确构建和运行，同时也提供了代码混淆和优化功能。