Nâng cấp Gradle cho Android

22.4.0 SDK Android của Google Mobile Ads đã thêm một phần tử <property> vào tệp kê khai Android. Để xây 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. Hướng dẫn này hướng dẫn bạn cách đảm bảo trình chỉnh sửa Unity của bạn 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 thành 21
  • Đặt cấp độ API mục tiêu thành 33 trở lên
  • Bật 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

Unity 2022.2 trở lên đi kèm với các phiên bản Gradle cho Android mới hơn theo mặc định. Bạn không cần thực hiện thêm hành động nào để hỗ trợ SDK Android 22.4.0 của Google Mobile Ads.

Unity 2022.1 trở về trước

Unity 2022.2 trở về trước sử dụng phiên bản Gradle cho Android cũ hơn mà SDK Android Quảng cáo của Google cho thiết bị di động 22.4.0 không 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 cần có dựa trên quy trình xây dựng:

  1. 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:

    • 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ụ bản 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 sẽ khác nhau một chút tuỳ thuộc vào việc bạn xuất dự án dưới dạng dự án Android Studio trong quá 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 phiên bản 6.7.1 xuống.

    Đặt đường dẫn Gradle trong Unity

    Trong Unity, hãy mở Unity Preferences (Lựa chọn ưu tiên của Unity) > External Tools (Công cụ bên ngoài) rồi đặt đườ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 tuỳ chọn Export Project (Xuất dự án) rồi đánh dấu vào tuỳ chọn này và nhấn 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à đặt 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