Nâng cấp Gradle cho Android

SDK Android quảng cáo trên thiết bị di động của Google 22.4.0 đã thêm một phần tử <property> vào tệp kê khai Android. Để xây dựng ứng dụng dựa trên phiên bản này trở lên, bạn cần sử dụng Gradle 6.7.1 trở lên và trình bổ trợ Android cho Gradle 4.2.0 trở lên. Bài viết này hướng dẫn bạn cách đảm bảo trình chỉnh sửa Unity tương thích.

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

Xem hết Hướng dẫn bắt đầu sử dụng. Hãy nhớ:

  • Đặt cấp độ API tối thiểu là 21
  • Đặt cấp độ API mục tiêu thành 33 trở lên
  • Bật các chế độ cài đặt Mẫu Gradle chính tuỳ chỉnh và Mẫu thuộc tính Gradle tuỳ chỉnh

Unity 2022.2 trở lên

Theo mặc định, Unity 2022.2 trở lên có các phiên bản Gradle cho Android mới hơn. Bạn không cần làm gì thêm để hỗ trợ SDK quảng cáo trên thiết bị di động của Google phiên bản 22.4.0.

Unity 2022.1 trở xuống

Unity phiên bản 2022.2 trở về trước sử dụng phiên bản Gradle cho Android cũ hơn. Phiên bản này không được SDK quảng cáo trên thiết bị di động của Google cho Android 22.4.0 hỗ trợ. Các bước sau đây cho biết cách nâng cấp lên phiên bản Gradle tối thiểu bắt buộc dựa trên quy trình xây dựng của bạn:

  1. Bật mẫu Gradle tuỳ chỉnh

    Chuyển đến Project Settings > Player > Android > Publishing Settings > Build (Cài đặt dự án > Trình phát > Android > Cài đặt xuất bản > Bản dựng) rồi chọn:

    • Mẫu Gradle cơ sở tuỳ chỉnh

  2. Sửa đổi mẫu Gradle cơ sở

    Mở tệp Assets/Plugins/Android/baseProjectTemplate.gradle và đặt các phần phụ thuộc để sử dụng công cụ xây dựng Gradle 4.2.0.

      allprojects {
      buildscript {
          dependencies {
              classpath 'com.android.tools.build:gradle:4.2.0'
              **BUILD_SCRIPT_DEPS**
          }
      }
  }
  ...

  3. Cập nhật Gradle

    Cập nhật phiên bản Gradle lên 6.7.1. Các bước thực hiện việc này hơi khác nhau tuỳ thuộc vào việc bạn có xuất dự án của mình dưới dạng dự án Android Studio trong quy trình xây dựng hay không.

    Bản dựng tích hợp Unity

    Cài đặt Gradle

    Tải Gradle xuống phiên bản 6.7.1.

    Thiết lập đường dẫn Gradle trong Unity

    Trong Unity, hãy mở Unity Preferences (Tuỳ chọn Unity > Công cụ bên ngoài) và thiết lập đường dẫn Gradle tuỳ chỉnh.

    Bản dựng Android Studio

    Xuất dự án Android Studio

    Mở trình đơn File > Build Settings (Tệp > Cài đặt bản dựng), bật Export Project (Xuất dự án) và nhấn vào nút Export (Xuất). Sau khi xuất, hãy mở dự án trong Android Studio.

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

    Mở tệp ./gradle/wrapper/gradle-wrapper.properties và thiết lập distributionUrl để sử dụng Gradle 6.7.1.

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