Android 3D 模型查看器教程

1. 项目目录结构及介绍

在the3deer/android-3D-model-viewer项目中，主要的目录结构如下：

• app: 本项目的主要应用模块，包含了Android应用程序的所有源代码和资源。
  • src/main/assets: 存放示例3D模型文件的地方。
  • src/main/java: 包含了主要的Java代码，包括Activity和自定义视图类。
• engine: 这个子模块是3D渲染引擎，负责处理图形渲染逻辑。
• fastlane: 自动化部署相关的配置。
• gradle/wrapper: Gradle构建工具的相关配置。
• licenses: 开源许可证文件。
• market: 应用市场相关的元数据。
• models: 可能包含额外的3D模型示例。
• screenshots: 应用程序截图。
• .gitignore: Git忽略文件列表。
• .gitmodules: 子模块配置。
• travis.yml: Travis CI持续集成配置。

2. 项目的启动文件介绍

项目的核心启动文件位于app/src/main/java/org/the3deer/app/model3D/MainActivity.java。这个Activity初始化并加载3D模型查看界面。它负责设置UI、加载模型以及处理用户交互事件，如手势识别以旋转和缩放3D模型。

// MainActivity.java简化示例
public class MainActivity extends AppCompatActivity {
    private ModelViewGLSurfaceView modelView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        modelView = findViewById(R.id.model_view);
        // 初始化3D模型查看器
        modelView.init();
        // 加载模型
        modelView.loadModel("path_to_model_file");
    }

    // ...其他方法，如处理触摸事件等...
}

在这个例子中，ModelViewGLSurfaceView是自定义的SurfaceView，用于渲染3D模型。loadModel()方法用来加载存储在本地或远程的3D模型。

3. 项目的配置文件介绍

build.gradle

在app/build.gradle 文件中，你可以找到项目的构建配置，例如依赖管理、版本号、编译选项等：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    buildToolsVersion "30.0.3"

    defaultConfig {
        applicationId "org.the3deer.app.model3D"
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"

        vectorDrawables.useSupportLibrary = true
    }
    
    // 省略其它配置...
}

dependencies {
    implementation 'com.google.code.gson:gson:2.8.6'
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.12.3'
    // 其他相关库...
}

这里，dependencies块列出了项目依赖的第三方库，比如Gson和Jackson库用于JSON操作。

settings.gradle

settings.gradle 文件用于定义项目的模块结构和包含的子模块，例如：

include ':app'
include ':engine'

这表明主项目包含了app和engine两个子模块。

.gitmodules

.gitmodules文件描述了项目的子模块信息，例如3D渲染引擎的Git路径：

[submodule "engine"]
    path = engine
    url = https://github.com/the3deer/android-3D-engine.git

如果你需要更新或克隆子模块，可以使用git submodule update --init命令。