Tổng quan về Play Feature Delivery

Mô hình phân phát ứng dụng của Google Play sử dụng định dạng Android App Bundle để tạo và phân phát các tệp APK được tối ưu hoá cho cấu hình thiết bị của từng người dùng, nhờ đó, người dùng chỉ cần tải mã và tài nguyên mà họ cần để chạy ứng dụng.

Play Feature Delivery sử dụng các tính năng nâng cao của gói ứng dụng để cho phép một số tính năng cụ thể của ứng dụng được phân phối theo điều kiện hoặc được tải xuống theo yêu cầu. Để làm được việc đó, trước tiên, bạn cần tách riêng những tính năng này khỏi ứng dụng cơ sở thành các mô-đun tính năng.

Cấu hình xây dựng mô-đun tính năng

Khi bạn tạo một mô-đun tính năng mới bằng Android Studio, IDE sẽ áp dụng trình bổ trợ Gradle sau đây cho tệp build.gradle của mô-đun.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

Nhiều thuộc tính hiện có cho trình bổ trợ ứng dụng chuẩn cũng có cho mô-đun tính năng. Các phần dưới đây mô tả những thuộc tính bạn nên và không nên đưa vào cấu hình xây dựng của mô-đun tính năng.

Thuộc tính không nên đưa vào cấu hình xây dựng mô-đun tính năng

Vì mỗi mô-đun tính năng lại phụ thuộc vào mô-đun cơ sở, nên mô-đun tính năng cũng kế thừa một số cấu hình cụ thể. Vì vậy, bạn nên bỏ các thuộc tính sau trong tệp build.gradle của mô-đun tính năng:

• Cấu hình ký tên: Gói ứng dụng được ký bằng cấu hình ký tên mà bạn chỉ định trong mô-đun cơ sở.
• Thuộc tính minifyEnabled: Bạn có thể bật tính năng rút gọn mã cho toàn bộ dự án ứng dụng trên cấu hình xây dựng của mô-đun cơ sở. Vì vậy, bạn nên bỏ thuộc tính này khỏi mô-đun tính năng. Tuy nhiên, bạn có thể chỉ định các quy tắc ProGuard bổ sung cho từng mô-đun tính năng.
• versionCode và versionName: Khi xây dựng gói ứng dụng, Gradle sử dụng thông tin phiên bản ứng dụng mà mô-đun cơ sở cung cấp. Bạn nên bỏ các thuộc tính này khỏi tệp build.gradle của mô-đun tính năng.

Thiết lập mối quan hệ với mô-đun cơ sở

Khi tạo mô-đun tính năng, Android Studio cho thấy mô-đun tính năng trong mô-đun cơ sở bằng cách thêm thuộc tính android.dynamicFeatures vào tệp build.gradle của mô-đun cơ sở, như trình bày dưới đây:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

Ngoài ra, Android Studio cũng bao gồm mô-đun cơ sở dưới dạng phần phụ thuộc của mô-đun tính năng, như trình bày dưới đây:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

Chỉ định quy tắc ProGuard bổ sung

Mặc dù chỉ có cấu hình xây dựng của mô-đun cơ sở mới có thể rút gọn mã cho dự án ứng dụng, nhưng bạn có thể cung cấp các quy tắc ProGuard tuỳ chỉnh cho từng mô-đun tính năng bằng cách sử dụng proguardFiles, như trình bày dưới đây:

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

Xin lưu ý rằng các quy tắc ProGuard này hợp nhất với các quy tắc từ những mô-đun khác (bao gồm cả mô-đun cơ sở) trong thời gian xây dựng. Vì vậy, mặc dù mỗi mô-đun tính năng có thể chỉ định một bộ quy tắc mới, nhưng những quy tắc đó sẽ áp dụng cho tất cả mô-đun trong dự án ứng dụng.

Triển khai ứng dụng

Trong khi phát triển ứng dụng để hỗ trợ mô-đun tính năng, bạn có thể triển khai ứng dụng cho một thiết bị được kết nối như bình thường bằng cách chọn Run (Chạy) > Run (Chạy) trên thanh trình đơn (hoặc bằng cách nhấp vào Run (Chạy) trên thanh công cụ).

Nếu dự án ứng dụng bao gồm một hoặc nhiều mô-đun tính năng, bạn có thể chọn tính năng cần đưa vào khi triển khai ứng dụng bằng cách sửa đổi cấu hình chạy/gỡ lỗi hiện có như sau:

1. Chọn Run (Chạy) > Edit Configurations (Chỉnh sửa cấu hình) trên thanh trình đơn.
2. Trên bảng điều khiển bên trái của hộp thoại Cấu hình chạy/gỡ lỗi, hãy chọn cấu hình Ứng dụng Android mà bạn muốn.
3. Trong phần Dynamic features to deploy (Tính năng động để triển khai) trên thẻ General (Chung), hãy đánh dấu hộp bên cạnh từng mô-đun tính năng bạn muốn đưa vào khi triển khai ứng dụng.
4. Nhấp vào OK.

Theo mặc định, Android Studio không triển khai ứng dụng bằng cách sử dụng gói ứng dụng để triển khai ứng dụng. Thay vào đó, IDE xây dựng và cài đặt các tệp APK được tối ưu hoá cho tốc độ triển khai trên thiết bị, thay vì kích thước tệp APK. Để định cấu hình Android Studio nhằm xây dựng và triển khai các tệp APK cũng như trải nghiệm tức thì trên một gói ứng dụng, hãy sửa đổi cấu hình chạy/gỡ lỗi.

Sử dụng mô-đun tính năng để phân phối theo phương thức tuỳ chỉnh

Lợi ích độc đáo của mô-đun tính năng là khả năng tuỳ chỉnh cách thức và thời điểm tải nhiều tính năng của ứng dụng xuống thiết bị chạy Android 5.0 (API cấp 21) trở lên. Ví dụ: để giảm kích thước tải xuống ban đầu của ứng dụng, bạn có thể định cấu hình một số tính năng để tải xuống theo nhu cầu hoặc chỉ tải xuống những thiết bị có hỗ trợ một số chức năng nhất định, chẳng hạn như khả năng chụp ảnh hoặc hỗ trợ các tính năng thực tế tăng cường.

Theo mặc định, khi tải ứng dụng lên dưới dạng một gói ứng dụng, bạn sẽ nhận được nội dung tải xuống có mức độ tối ưu hoá cao, nhưng các tuỳ chọn phân phối tính năng nâng cao và có mức độ tuỳ chỉnh cao hơn sẽ đòi hỏi bạn phải định cấu hình bổ sung và mô-đun hoá tính năng của ứng dụng bằng mô-đun tính năng. Tức là mô-đun tính năng cung cấp khối xây dựng để tạo tính năng mô-đun mà bạn có thể định cấu hình để mỗi tính năng được tải xuống khi cần.

Hãy xem xét một ứng dụng cho phép người dùng mua và bán hàng hoá trên trang web thương mại trực tuyến. Bạn có thể mô-đun hoá một cách hợp lý từng chức năng sau đây của ứng dụng thành các mô-đun tính năng riêng biệt:

• Đăng nhập và tạo tài khoản
• Duyệt qua trang web thương mại
• Đăng hàng để bán
• Xử lý khoản thanh toán

Bảng dưới đây mô tả nhiều tuỳ chọn phân phối có hỗ trợ mô-đun tính năng cũng như cách bạn có thể dùng các tuỳ chọn đó để tối ưu hoá kích thước tải xuống ban đầu của ứng dụng trang web thương mại mẫu.

Xây dựng URI cho tài nguyên

Nếu bạn muốn dùng URI để truy cập tài nguyên lưu trữ trong mô-đun tính năng, thì sau đây là cách tạo URI tài nguyên cho mô-đun tính năng bằng Uri.Builder():

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

Từng phần của đường dẫn đến tài nguyên được xây dựng trong khi chạy, đảm bảo rằng không gian tên chính xác được tạo sau khi tệp APK phân tách được tải.

Hãy xem một ví dụ về cách tạo URI, giả sử bạn có một ứng dụng và mô-đun tính năng với các tên sau đây:

• Tên gói ứng dụng: com.example.my_app_package
• Tên gói tài nguyên của tính năng: com.example.my_app_package.my_dynamic_feature

Nếu resId trong đoạn mã ở trên tham chiếu đến một tài nguyên tệp thô có tên "my_video" trong mô-đun tính năng, thì mã Uri.Builder() ở trên sẽ đưa ra kết quả như sau:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

Sau đó, ứng dụng của bạn có thể sử dụng URI này để truy cập tài nguyên đó của mô-đun tính năng.

Để xác thực đường dẫn trong URI, bạn có thể sử dụng APK Analyzer (Công cụ phân tích APK) để kiểm tra tệp APK mô-đun tính năng và xác định tên gói:

Những điểm cần lưu ý về mô-đun tính năng

Các mô-đun tính năng có thể giúp bạn cải thiện tốc độ xây dựng và tốc độ kỹ thuật, đồng thời điều chỉnh trên quy mô lớn hoạt động phân phối các tính năng của ứng dụng để giảm kích thước ứng dụng. Tuy nhiên, có một số hạn chế và trường hợp đặc biệt cần lưu ý khi sử dụng mô-đun tính năng:

• Việc cài đặt 50 mô-đun tính năng trở lên trên một thiết bị, thông qua phương thức phân phối có điều kiện hoặc theo yêu cầu, có thể dẫn đến các vấn đề về hiệu suất. Các mô-đun phân phối tại thời điểm cài đặt (không được định cấu hình là có thể xoá) sẽ tự động được đưa vào mô-đun cơ sở và chỉ được tính là một mô-đun tính năng trên mỗi thiết bị.
• Giới hạn số lượng mô-đun được cấu hình là có thể xoá cho hình thức phân phối tại thời điểm cài đặt trong khoảng 10 trở xuống. Nếu không, thời gian tải xuống và cài đặt của ứng dụng có thể tăng lên.
• Chỉ thiết bị chạy Android 5.0 (API cấp 21) trở lên mới hỗ trợ hoạt động tải xuống và cài đặt tính năng theo yêu cầu. Để cung cấp tính năng cho các phiên bản Android trước đó, hãy bật tính năng Fusing (Hợp nhất) khi bạn tạo một mô-đun tính năng.
• Bật SplitCompat để ứng dụng có quyền truy cập vào các mô-đun tính năng đã tải xuống được phân phối theo yêu cầu.
• Mô-đun tính năng không được chỉ định hoạt động trong tệp kê khai khi android:exported được đặt thành true. Lý do là không có gì đảm bảo rằng thiết bị đã tải mô-đun tính năng xuống khi một ứng dụng khác cố gắng khởi chạy hoạt động đó. Ngoài ra, ứng dụng phải xác nhận rằng một tính năng đã được tải xuống trước khi cố gắng truy cập vào mã và tài nguyên của tính năng đó. Để tìm hiểu thêm, hãy đọc nội dung Quản lý mô-đun đã cài đặt.
• Vì Play Feature Delivery yêu cầu bạn phải phát hành ứng dụng bằng gói ứng dụng, hãy đảm bảo rằng bạn đã nắm được các vấn đề đã biết liên quan đến gói ứng dụng.

Tài liệu tham khảo về tệp kê khai mô-đun tính năng

Khi tạo một mô-đun tính năng mới bằng Android Studio, IDE sẽ bao gồm hầu hết thuộc tính tệp kê khai mà mô-đun này đòi hỏi phải hoạt động như một mô-đun tính năng. Ngoài ra, có một số thuộc tính được hệ thống xây dựng chèn vào tại thời điểm biên dịch. Vì vậy, bạn không cần chỉ định hoặc tự sửa đổi các thuộc tính đó. Bảng sau đây mô tả các thuộc tính tệp kê khai quan trọng đối với mô-đun tính năng.

Tài nguyên khác

Để tìm hiểu thêm về cách sử dụng mô-đun tính năng, hãy thử tham khảo các tài nguyên sau đây.

Bài đăng trên blog

• Các tính năng mới giúp bạn phát triển ứng dụng, phát hành ứng dụng và phát triển hoạt động kinh doanh trên Google Play
• Bản cập nhật mới nhất cho Android App Bundle (bao gồm cả API bổ sung cho ngôn ngữ)
• Patchwork Plaid – Câu chuyện về mô-đun hoá

Video

• Có thể tuỳ chỉnh tính năng phân phối nhờ Gói ứng dụng và dễ dàng chia sẻ bản thử nghiệm
• Công cụ mới giúp tối ưu hoá kích thước ứng dụng và tăng số lượt cài đặt trên Google Play

Điều khoản dịch vụ và an toàn dữ liệu

Bằng cách truy cập hoặc sử dụng Thư viện Play Feature Delivery bạn đồng ý với Điều khoản dịch vụ của Bộ phát triển phần mềm Play Core. Vui lòng đọc và hiểu tất cả điều khoản và chính sách hiện hành trước khi truy cập thư viện.

An toàn dữ liệu

Thư viện Play Core mang đến giao diện trong thời gian chạy cho ứng dụng trên Cửa hàng Google Play. Do đó, khi bạn sử dụng Play Core trong ứng dụng, Cửa hàng Play sẽ chạy các quy trình riêng, trong đó có hoạt động xử lý dữ liệu chịu sự điều chỉnh của Điều khoản dịch vụ của Google Play. Thông tin dưới đây mô tả cách thư viện Play Core xử lý dữ liệu để giải quyết các yêu cầu cụ thể của ứng dụng.

API ngôn ngữ bổ sung

Play Feature Delivery

Mặc dù chúng tôi hướng đến sự minh bạch tối đa, nhưng bạn hoàn toàn chịu trách nhiệm về việc phản hồi biểu mẫu mục an toàn dữ liệu của Google Play liên quan đến hoạt động thu thập và chia sẻ dữ liệu người dùng trên ứng dụng của bạn cùng với các phương pháp bảo mật.