Sceneform Android 项目教程

1. 项目的目录结构及介绍

Sceneform Android 项目的目录结构如下：

sceneform-android/
├── app/
│   ├── build.gradle
│   ├── proguard-rules.pro
│   └── src/
│       ├── androidTest/
│       ├── main/
│       │   ├── AndroidManifest.xml
│       │   ├── java/
│       │   └── res/
│       └── test/
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── sceneformsrc/
    ├── build.gradle
    ├── proguard-rules.pro
    └── src/
        ├── main/
        │   ├── AndroidManifest.xml
        │   ├── java/
        │   └── res/
        └── test/

目录结构介绍

• app/: 包含应用程序的主要代码和资源。

  • build.gradle: 应用程序的构建脚本。
  • proguard-rules.pro: Proguard 配置文件。
  • src/: 源代码目录。
    • androidTest/: 包含 Android 测试代码。
    • main/: 包含主要代码和资源。
      • AndroidManifest.xml: 应用程序的清单文件。
      • java/: 包含 Java 源代码。
      • res/: 包含资源文件，如布局、图像等。
    • test/: 包含单元测试代码。

• sceneformsrc/: 包含 Sceneform 库的源代码和资源。

  • build.gradle: Sceneform 库的构建脚本。
  • proguard-rules.pro: Sceneform 库的 Proguard 配置文件。
  • src/: 源代码目录。
    • main/: 包含主要代码和资源。
      • AndroidManifest.xml: Sceneform 库的清单文件。
      • java/: 包含 Java 源代码。
      • res/: 包含资源文件，如布局、图像等。
    • test/: 包含单元测试代码。

2. 项目的启动文件介绍

Sceneform Android 项目的启动文件是 app/src/main/java/com/example/sceneform/MainActivity.java。这个文件是应用程序的主活动，负责初始化和启动 Sceneform 视图。

package com.example.sceneform;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import com.google.ar.sceneform.ux.ArFragment;

public class MainActivity extends AppCompatActivity {
    private ArFragment arFragment;

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

        arFragment = (ArFragment) getSupportFragmentManager().findFragmentById(R.id.ar_fragment);
    }
}

启动文件介绍

• MainActivity.java: 应用程序的主活动。
  • onCreate(): 初始化活动并设置内容视图。
  • arFragment: 初始化 AR 片段。

3. 项目的配置文件介绍

Sceneform Android 项目的主要配置文件包括 app/build.gradle 和 app/src/main/AndroidManifest.xml。

build.gradle

apply plugin: 'com.android.application'
apply plugin: 'com.google.ar.sceneform.plugin'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.example.sceneform"
        minSdkVersion 24
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'com.google.ar.sceneform.ux:sceneform-ux:1.17.1'
    implementation 'com.google.ar.sceneform:core:1.17.1'
}

sceneform.asset('sampledata/models/andy.obj',
        'default',
        'sampledata