Trang này được dịch bởi Cloud Translation API.

Khả năng tương thích của Trình chỉnh sửa Unity với Android

Trình chỉnh sửa Unity bị khoá phiên bản thành một phiên bản cụ thể của Gradle. Phiên bản này có thể xung đột với các phần phụ thuộc mà các gói Android mới hơn yêu cầu, chẳng hạn như Google Mobile Ads. Hướng dẫn sau đây hướng dẫn bạn cách tạo bản dựng Android trên các phiên bản cũ của Trình chỉnh sửa Unity.

Bảng sau đây đề xuất phiên bản trình bổ trợ Google Mobile Ads tương thích tối đa để sử dụng dựa trên Trình chỉnh sửa Unity của bạn.

Trình chỉnh sửa Unity	Phiên bản trình bổ trợ Google Mobile Ads cho Unity được đề xuất
2023.1 trở lên	Mới nhất
2021.3.41f1 – 2022.3	9.1.0
2021.3.37f1 trở về trước	8.5.3

Điều kiện tiên quyết

Tải và cài đặt phiên bản ổn định mới nhất của Android Studio.
Để hiểu rõ hơn về cách tạo bản dựng cho Android, hãy đọc bài viết Phiên bản Java trong các bản dựng Android.

Cập nhật chế độ cài đặt bản dựng 2022.3 trở về trước

Unity 2022.3 trở xuống yêu cầu thay đổi chế độ cài đặt bản dựng trước khi xuất sang Android Studio.

Tạo baseProjectTemplate.gradle

Bật mẫu Gradle tuỳ chỉnh. Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Android > Publishing Settings (Cài đặt phát hành) > Build (Bản dựng) rồi chọn Custom Base Gradle Template (Mẫu Gradle cơ sở tuỳ chỉnh). Thao tác này sẽ tạo tệp Plugins/Android/baseProjectTemplate.gradle.

Sửa đổi tệp Plugins/Android/baseProjectTemplate.gradle để sử dụng các công cụ Gradle phiên bản 8.1.1 trở lên.

plugins {
    id 'com.android.application' version '8.1.1' apply false
    id 'com.android.library' version '8.1.1' apply false
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

Các thay đổi bổ sung cho Unity 2021.3.37f1 trở về trước

Unity 2021.3.37f1 trở về trước yêu cầu thêm các thay đổi để nâng cấp khả năng tương thích lên Gradle 8.1.1. Hãy hoàn tất các bước sau:

Tạo launcherTemplate.gradle

Chuyển đến Project Settings (Cài đặt dự án) > Player (Trình phát) > Android > Publishing Settings (Cài đặt phát hành) > Build (Bản dựng) rồi chọn Launcher Gradle Template (Mẫu Gradle của trình chạy). Thao tác này sẽ tạo tệp Plugins/Android/launcherTemplate.gradle.
Sửa đổi Plugins/Android/launcherTemplate.gradle để thêm thuộc tính không gian tên. Giá trị thuộc tính không gian tên phải khớp với thuộc tính gói có trong tệp AndroidManifest.xml của mô-đun trình chạy.
```
android {
    // TODO: Replace with your app's package name.
    namespace 'com.google.android.gms.example'
}
```

Tạo mainTemplate.gradle

Chuyển đến Project Settings > Player > Android > Publishing Settings > Build (Cài đặt dự án > Trình phát > Android > Cài đặt phát hành > Bản dựng) rồi chọn Main Gradle Template (Mẫu Gradle chính). Thao tác này sẽ tạo tệp Plugins/Android/mainTemplate.gradle.

Sửa đổi Plugins/Android/mainTemplate.gradle để thêm thuộc tính không gian tên có giá trị com.unity3d.player.
```
android {
    namespace 'com.unity3d.player'
}
```

Xuất sang Android Studio

Sửa đổi chế độ cài đặt bản dựng Android để xuất dự án Unity.
Để xuất sang Android Studio, hãy sửa đổi chế độ cài đặt bản dựng Android. Chọn File (Tệp) (hoặc Unity Editor (Trình chỉnh sửa Unity) trên macOS) > Build Settings (Cài đặt bản dựng) rồi đánh dấu vào Export Project (Xuất dự án):
Nhấn vào nút Export (Xuất) ở cuối hộp thoại Build Settings (Cài đặt bản dựng). Unity sẽ tạo một dự án Android tại vị trí đã chọn.
Mở dự án đã xuất trong Android Studio.

Cập nhật cấu hình JDK Gradle để sử dụng JDK 17

Sử dụng Android Studio, hãy mở phần cài đặt Gradle từ File (Tệp) (hoặc Android Studio trên macOS) > Settings > Build, Execution, Deployment > Build Tools > Gradle (Cài đặt > Xây dựng, Thực thi, Triển khai > Công cụ xây dựng > Gradle).
Tìm trình đơn thả xuống Gradle JDK. Sửa đổi JDK Gradle để sử dụng JDK 17.

Nếu bạn chưa cài đặt JDK 17, hãy chọn tuỳ chọn Download JDK (Tải JDK xuống) trong trình đơn thả xuống Gradle JDK rồi tải một phiên bản tương thích xuống. Bạn nên sử dụng nhà cung cấp thời gian chạy JetBrains có hỗ trợ arch64 để phù hợp với nội dung mà Android Studio phân phối.

Cập nhật tệp trình bao bọc Gradle

Sửa đổi tham số distributionUrl bên trong gradle/wrapper/gradle-wrapper.properties để sử dụng Gradle 8.0.1 trở lên.

   distributionBase=GRADLE_USER_HOME
   distributionPath=wrapper/dists
   zipStoreBase=GRADLE_USER_HOME
   zipStorePath=wrapper/dists
   distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.1-bin.zip

Các thay đổi khác về Android Studio cho Unity 2021.3.37f1 trở xuống

Unity 2021.3.37f1 trở về trước yêu cầu thêm các thay đổi để nâng cấp khả năng tương thích lên Gradle 8.1.1. Hãy hoàn tất các bước sau:

Sửa đổi gradle.properties và xoá thuộc tính android.enableR8=false.

Sửa đổi unityLibrary/GoogleMobileAdsPlugin.androidlib/build.gradle và thêm thuộc tính không gian tên có giá trị "com.google.unity.ads":

apply plugin: 'android-library'

dependencies {
    implementation fileTree(dir: 'bin', include: ['*.jar'])
    implementation fileTree(dir: 'libs', include: ['*.jar'])
}

android {
    namespace "com.google.unity.ads"
    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            //java.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']
            jniLibs.srcDirs = ['libs']
        }
    }

    compileSdkVersion 35
    buildToolsVersion '30.0.3'
    defaultConfig {
        targetSdkVersion 31
    }

    lintOptions {
        abortOnError false
    }
}

Chạy dự án Android

Sau khi hoàn tất các bước này, ứng dụng Unity đã sẵn sàng. Trong Android Studio, hãy chạy tính năng đồng bộ hoá Gradle và chạy dự án.