Hướng dẫn cài đặt XenseAR SDK cho Flutter Android

Chuẩn bị:

Tải Project mẫu từ Trang tải xuống.
Tải thư viện tương ứng (SDK) từ Trang tải xuống.
Flutter Project cần thực hiện tích hợp.

Quy trình tích hợp:

1. Chạy thử Template project trên máy để hiểu sơ qua về thư viện

Chạy lệnh trong terminal


 flutter run

2. Tạo một folder libs trong <flutter root>/android/app/, sau đó copy các nội dung sau từ SDK:

unityLibrary-release.arr
Tất cả file trong folder libs

3. Thực hiện các chỉnh sửa sau trong <flutter root>/android/app/build.gradle.kts

Lưu ý: tự convert qua syntax theo config của project cần tích hợp


  //...
  android {
      //...
      ndkVersion = "27.2.12479018"
      //...
      defaultConfig {
          //...
          minSdk = 26
          targetSdk = 35
          //...
      }
 
      buildTypes {
          release {
              //...
              isMinifyEnabled = false
              isShrinkResources = false
          }
      }
  }
  dependencies {
      implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar"))))
  }
  //...

4. Thêm nội dung file <flutter root>/android/app/src/main/res/values/string.xml


  <resources>
    <!-- ... -->
    <string name="game_view_content_description">GameView</string>
  </resources>

5. Sửa nội dung file <flutter root>/android/build.gradle.kts

Lưu ý: tự convert qua syntax theo config của project cần tích hợp


  allprojects {
      repositories {
          //...
          flatDir {
              dirs("libs")
          }
      }
  }
//...

6. Trong folder chứa file MainActivity.kt, tạo mới các file sau:

MainUnityActivity.kt
XenseAREventManager.kt
XenseARManager.kt

Thực hiện copy nội dung các file sau từ Template project:

MainActivity.kt
MainUnityActivity.kt
XenseAREventManager.kt
XenseARManager.kt

7. Thực hiện sửa file AndroidManifest.xml


  <manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        <!-- ... -->
 
        <activity
            android:label="@string/app_name"
            android:name="<your-app-namespace>.MainUnityActivity"
            android:screenOrientation="fullSensor"
            android:configChanges="mcc|mnc|locale|touchscreen|keyboard|keyboardHidden|navigation|orientation|screenLayout|uiMode|screenSize|smallestScreenSize|fontScale|layoutDirection|density"
            android:hardwareAccelerated="true"
            >
        </activity>
 
        <!-- ... -->
      </application>
 
      <!-- ... -->
  </manifest>

8. Sau khi thực hiện các bước trên, chuyển qua Trang sử dụng để xem cách sử dụng trong Flutter.