Tạo nhiều APK cho các cấp độ API khác nhau

Nếu bạn phát hành ứng dụng lên Google Play thì bạn nên tạo và tải một Android App Bundle lên. Khi bạn làm như vậy, Google Play sẽ tự động 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 mỗi người dùng. Vì vậy, họ chỉ tải mã và tài nguyên mà họ cần để chạy ứng dụng của bạn. Việc phát hành nhiều tệp APK sẽ hữu ích nếu bạn không phát hành lên Google Play, nhưng bạn phải tự tạo, ký và quản lý từng tệp APK.

Khi phát triển ứng dụng Android để tận dụng nhiều APK trên Google Play, bạn cần áp dụng một số phương pháp hay ngay từ đầu để tránh gặp phải những vấn đề không cần thiết trong quá trình phát triển. Bài này hướng dẫn bạn cách tạo nhiều tệp APK của ứng dụng, mỗi tệp APK bao gồm một phạm vi cấp độ API hơi khác nhau. Bạn cũng sẽ có được một số công cụ cần thiết để duy trì cơ sở mã APK nhiều nhất có thể.

Xác nhận rằng bạn cần nhiều tệp APK

Khi cố gắng tạo một ứng dụng hoạt động trên nhiều thế hệ nền tảng Android, bạn muốn ứng dụng của mình tận dụng các tính năng mới trên thiết bị mới mà không làm mất khả năng tương thích ngược. Ban đầu, có vẻ như việc hỗ trợ nhiều APK là giải pháp tốt nhất, nhưng thường thì không phải vậy. Phần Sử dụng một tệp APK trong hướng dẫn dành cho nhà phát triển về nhiều tệp APK có một số thông tin hữu ích về cách thực hiện việc này bằng một tệp APK, bao gồm cả việc sử dụng thư viện hỗ trợ của chúng tôi. Bạn cũng có thể tìm hiểu cách viết mã chỉ chạy ở một số cấp độ API nhất định trong một tệp APK duy nhất mà không cần sử dụng các kỹ thuật tốn kém về mặt tính toán như phản chiếu trong bài viết này.

Nếu bạn có thể quản lý được, việc giới hạn ứng dụng của bạn trong một tệp APK sẽ có một số lợi thế, bao gồm:

  • Dễ dàng phát hành và kiểm thử hơn
  • Chỉ có một cơ sở mã để duy trì
  • Ứng dụng của bạn có thể thích ứng với các thay đổi về cấu hình thiết bị
  • Khôi phục ứng dụng trên nhiều thiết bị
  • Bạn không phải lo lắng về lựa chọn ưu tiên của thị trường, hành vi "nâng cấp" từ APK này sang APK khác hoặc APK nào phù hợp với loại thiết bị nào

Phần còn lại của bài học này giả định rằng bạn đã nghiên cứu chủ đề này, chăm chỉ tiếp thu tài liệu trong các tài nguyên được liên kết và xác định rằng nhiều tệp APK là con đường phù hợp cho ứng dụng của bạn.

Lập biểu đồ các yêu cầu

Bắt đầu bằng cách tạo một biểu đồ đơn giản để nhanh chóng xác định số lượng APK bạn cần và phạm vi API mà mỗi APK bao gồm. Để tham khảo nhanh, trang Phiên bản nền tảng của trang web dành cho nhà phát triển Android cung cấp dữ liệu về số lượng tương đối của các thiết bị đang hoạt động chạy một phiên bản nhất định của nền tảng Android. Ngoài ra, mặc dù thoạt nghe có vẻ dễ dàng, nhưng việc theo dõi bộ cấp độ API mà mỗi APK sẽ nhắm đến sẽ trở nên khó khăn khá nhanh, đặc biệt là nếu có một số cấp độ trùng lặp (thường là có). May mắn là bạn có thể lập biểu đồ các yêu cầu của mình một cách nhanh chóng, dễ dàng và có thể tham khảo sau này.

Để tạo biểu đồ nhiều APK, hãy bắt đầu bằng một hàng ô đại diện cho các cấp độ API khác nhau của nền tảng Android. Thêm một ô bổ sung ở cuối để biểu thị các phiên bản Android trong tương lai.

3 4 5 6 7 8 9 10 11 12 13 +

Bây giờ, bạn chỉ cần tô màu trong biểu đồ sao cho mỗi màu đại diện cho một APK. Dưới đây là một ví dụ về cách bạn có thể áp dụng từng tệp APK cho một phạm vi cấp độ API nhất định.

3 4 5 6 7 8 9 10 11 12 13 +

Sau khi tạo biểu đồ này, hãy phân phối biểu đồ đó cho nhóm của bạn. Việc giao tiếp trong nhóm về dự án của bạn trở nên đơn giản hơn ngay lập tức, vì thay vì hỏi "Tệp APK cho API cấp 3 đến 6 thế nào, er, bạn biết đấy, tệp APK cho Android 1.x. Công việc đó tiến triển như thế nào?" Bạn chỉ cần nói "Tình hình APK Blue như thế nào?"

Đặt tất cả mã và tài nguyên phổ biến vào một dự án thư viện

Cho dù bạn đang sửa đổi một ứng dụng Android hiện có hay bắt đầu một ứng dụng từ đầu, đây là điều đầu tiên bạn nên làm với cơ sở mã và quan trọng nhất. Mọi nội dung đi vào dự án thư viện chỉ cần được cập nhật một lần (hãy nghĩ đến các chuỗi được bản địa hoá theo ngôn ngữ, giao diện màu sắc, lỗi được khắc phục trong mã dùng chung), giúp cải thiện thời gian phát triển và giảm khả năng mắc lỗi mà bạn có thể dễ dàng tránh được.

Lưu ý: Mặc dù thông tin chi tiết về cách triển khai để tạo và đưa các dự án thư viện vào nằm ngoài phạm vi của bài học này, nhưng bạn có thể nắm bắt nhanh bằng cách đọc bài viết Tạo thư viện Android.

Nếu bạn đang chuyển đổi một ứng dụng hiện có để sử dụng tính năng hỗ trợ nhiều APK, hãy tìm kiếm trong cơ sở mã của bạn mọi tệp chuỗi đã bản địa hoá, danh sách giá trị, màu giao diện, biểu tượng trình đơn và bố cục sẽ không thay đổi trên các APK, đồng thời đặt tất cả vào dự án thư viện. Mã không thay đổi nhiều cũng nên được đưa vào dự án thư viện. Bạn có thể sẽ thấy mình mở rộng các lớp này để thêm một hoặc hai phương thức từ APK sang APK.

Mặt khác, nếu bạn đang tạo ứng dụng từ đầu, hãy cố gắng viết mã trong dự án thư viện trước tiên, sau đó chỉ di chuyển mã đó xuống một tệp APK riêng lẻ nếu cần. Việc này sẽ dễ quản lý hơn nhiều về lâu dài so với việc thêm blob vào một thư mục, rồi thêm vào một thư mục khác, rồi thêm vào một thư mục khác, sau đó nhiều tháng sau mới tìm cách xem liệu blob này có thể được chuyển lên phần thư viện mà không làm hỏng bất kỳ nội dung nào không.

Tạo dự án APK mới

Bạn nên tạo một dự án Android riêng cho mỗi tệp APK mà bạn sắp phát hành. Để dễ dàng sắp xếp, hãy đặt dự án thư viện và tất cả dự án APK có liên quan trong cùng một thư mục mẹ. Ngoài ra, hãy nhớ rằng mỗi tệp APK cần có cùng một tên gói, mặc dù các tệp này không nhất thiết phải chia sẻ tên gói với thư viện. Nếu bạn có 3 tệp APK theo lược đồ mô tả ở trên, thư mục gốc của bạn có thể có dạng như sau:

alexlucas:~/code/multi-apks-root$ ls
foo-blue
foo-green
foo-lib
foo-red

Sau khi tạo các dự án, hãy thêm dự án thư viện làm tham chiếu cho từng dự án APK. Nếu có thể, hãy xác định Hoạt động bắt đầu trong dự án thư viện và mở rộng Hoạt động đó trong dự án APK. Việc xác định một hoạt động bắt đầu trong dự án thư viện giúp bạn có cơ hội đưa tất cả các hoạt động khởi chạy ứng dụng vào cùng một nơi, nhờ đó, mỗi tệp APK riêng lẻ không phải triển khai lại các tác vụ "phổ quát" như khởi chạy Analytics, chạy quy trình kiểm tra giấy phép và mọi quy trình khởi chạy khác không thay đổi nhiều từ APK này sang APK khác.

Điều chỉnh tệp kê khai

Khi người dùng tải một ứng dụng sử dụng nhiều tệp APK xuống thông qua Google Play, tệp APK chính xác để sử dụng sẽ được chọn theo hai quy tắc đơn giản:

  • Tệp kê khai phải cho thấy rằng APK cụ thể đó đủ điều kiện
  • Trong số các tệp APK đủ điều kiện, tệp có số phiên bản cao nhất sẽ chiến thắng

Ví dụ: hãy lấy tập hợp nhiều APK được mô tả ở trên và giả sử chúng ta chưa đặt cấp độ API tối đa cho bất kỳ APK nào. Nếu xem riêng lẻ, phạm vi có thể có của mỗi APK sẽ có dạng như sau:

3 4 5 6 7 8 9 10 11 12 13 +
3 4 5 6 7 8 9 10 11 12 13 +
3 4 5 6 7 8 9 10 11 12 13 +

Vì bắt buộc một tệp APK có minSdkVersion cao hơn cũng phải có mã phiên bản cao hơn, nên chúng ta biết rằng về giá trị versionCode, màu đỏ ≥ màu xanh lục ≥ màu xanh dương. Do đó, chúng ta có thể thu gọn biểu đồ một cách hiệu quả như sau:

3 4 5 6 7 8 9 10 11 12 13 +

Bây giờ, hãy giả định thêm rằng APK màu đỏ có một số yêu cầu mà hai APK còn lại không có. Trang Bộ lọc trên Google Play trong hướng dẫn dành cho nhà phát triển Android có toàn bộ danh sách các nguyên nhân có thể gây ra vấn đề. Ví dụ: giả sử màu đỏ yêu cầu máy ảnh mặt trước. Trên thực tế, toàn bộ điểm của tệp APK màu đỏ là kết hợp máy ảnh mặt trước với chức năng mới thú vị được thêm vào API 11. Nhưng hóa ra, không phải thiết bị nào hỗ trợ API 11 đều CÓ máy ảnh mặt trước! Thật kinh hoàng!

May mắn thay, nếu người dùng đang duyệt xem Google Play trên một thiết bị như vậy, Google Play sẽ xem tệp kê khai, thấy rằng Red liệt kê máy ảnh mặt trước là một yêu cầu và âm thầm bỏ qua yêu cầu đó, vì đã xác định rằng Red và thiết bị đó không phù hợp với nhau. Sau đó, bạn sẽ thấy rằng Green không chỉ tương thích chuyển tiếp với các thiết bị có API 11 (vì không có maxSdkVersion nào được xác định), mà còn không quan tâm đến việc có máy ảnh mặt trước hay không! Người dùng vẫn có thể tải ứng dụng xuống từ Google Play, vì mặc dù toàn bộ sự cố với camera trước, nhưng vẫn có một tệp APK hỗ trợ cấp độ API cụ thể đó.

Để giữ tất cả tệp APK trên các "đường dẫn" riêng biệt, bạn cần có một lược đồ mã phiên bản tốt. Bạn có thể tìm thấy mã được đề xuất trong phần Mã phiên bản của hướng dẫn dành cho nhà phát triển. Vì tập hợp ví dụ về tệp APK chỉ xử lý một trong 3 nhóm kích thước có thể có, nên bạn chỉ cần tách mỗi tệp APK theo 1000, đặt hai chữ số đầu tiên thành minSdkVersion cho tệp APK cụ thể đó và tăng dần từ đó. Mã có thể như sau:

Xanh dương: 03001, 03002, 03003, 03004...
Xanh lục: 07001, 07002, 07003, 07004...
Đỏ:11001, 11002, 11003, 11004...

Khi kết hợp tất cả những thông tin này, Tệp kê khai Android của bạn có thể sẽ có dạng như sau:

Màu lam:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="03001" android:versionName="1.0" package="com.example.foo">
    <uses-sdk android:minSdkVersion="3" />
    ...

Màu lục:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="07001" android:versionName="1.0" package="com.example.foo">
    <uses-sdk android:minSdkVersion="7" />
    ...

Màu đỏ:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="11001" android:versionName="1.0" package="com.example.foo">
    <uses-sdk android:minSdkVersion="11" />
    ...

Xem lại danh sách kiểm tra trước khi ra mắt

Trước khi tải lên Google Play, hãy kiểm tra kỹ các mục sau. Xin lưu ý rằng những điều này liên quan cụ thể đến nhiều tệp APK và không thể hiện danh sách kiểm tra đầy đủ cho tất cả ứng dụng được tải lên Google Play.

  • Tất cả tệp APK phải có cùng tên gói
  • Tất cả tệp APK phải được ký bằng cùng một chứng chỉ
  • Nếu các APK trùng lặp về phiên bản nền tảng, thì tệp APK có minSdkVersion cao hơn phải có mã phiên bản cao hơn
  • Kiểm tra kỹ bộ lọc tệp kê khai để tìm thông tin xung đột (không ai sẽ thấy tệp APK chỉ hỗ trợ cupcake trên màn hình XLARGE)
  • Tệp kê khai của mỗi tệp APK phải là duy nhất trên ít nhất một trong các màn hình, kết cấu OpenGL hoặc phiên bản nền tảng được hỗ trợ
  • Hãy thử kiểm thử từng tệp APK trên ít nhất một thiết bị. Ngoài ra, bạn có một trong những trình mô phỏng thiết bị có thể tuỳ chỉnh nhất trong ngành trên máy phát triển của mình. Chúc bạn thành công!

Bạn cũng nên kiểm tra APK đã biên dịch trước khi đẩy ra thị trường để đảm bảo không có bất kỳ điều gì bất ngờ có thể ẩn ứng dụng của bạn trên Google Play. Việc này thực sự khá đơn giản khi sử dụng công cụ "aapt". Aapt (Công cụ đóng gói tài nguyên Android) là một phần của quy trình tạo bản dựng để tạo và đóng gói ứng dụng Android, đồng thời cũng là một công cụ rất hữu ích để kiểm tra các ứng dụng đó.

>aapt dump badging
package: name='com.example.hello' versionCode='1' versionName='1.0'
sdkVersion:'11'
uses-permission:'android.permission.SEND_SMS'
application-label:'Hello'
application-icon-120:'res/drawable-ldpi/icon.png'
application-icon-160:'res/drawable-mdpi/icon.png'
application-icon-240:'res/drawable-hdpi/icon.png'
application: label='Hello' icon='res/drawable-mdpi/icon.png'
launchable-activity: name='com.example.hello.HelloActivity'  label='Hello' icon=''
uses-feature:'android.hardware.telephony'
uses-feature:'android.hardware.touchscreen'
main
supports-screens: 'small' 'normal' 'large' 'xlarge'
supports-any-density: 'true'
locales: '--_--'
densities: '120' '160' '240'

Khi kiểm tra kết quả aapt, hãy nhớ kiểm tra để đảm bảo bạn không có các giá trị xung đột cho màn hình hỗ trợ và màn hình tương thích, cũng như không có các giá trị "sử dụng tính năng" không mong muốn được thêm do các quyền bạn đặt trong tệp kê khai. Trong ví dụ trên, nhiều thiết bị sẽ không thấy tệp APK.

Tại sao? Bằng cách thêm quyền bắt buộc SEND_SMS, yêu cầu về tính năng của android.hardware.telephony đã được thêm ngầm ẩn. Vì API 11 là Honeycomb (phiên bản Android được tối ưu hoá riêng cho máy tính bảng) và không có thiết bị Honeycomb nào có phần cứng điện thoại, nên Google Play sẽ lọc ra tệp APK này trong mọi trường hợp, cho đến khi các thiết bị trong tương lai có cấp độ API cao hơn VÀ có phần cứng điện thoại.

May mắn là bạn có thể dễ dàng khắc phục vấn đề này bằng cách thêm nội dung sau vào tệp kê khai:

<uses-feature android:name="android.hardware.telephony" android:required="false" />

Yêu cầu android.hardware.touchscreen cũng được thêm ngầm ẩn. Nếu muốn tệp APK hiển thị trên TV không phải là thiết bị màn hình cảm ứng, bạn nên thêm nội dung sau vào tệp kê khai:

<uses-feature android:name="android.hardware.touchscreen" android:required="false" />

Sau khi hoàn tất danh sách kiểm tra trước khi phát hành, hãy tải tệp APK lên Google Play. Có thể mất chút thời gian để ứng dụng xuất hiện khi duyệt qua Google Play, nhưng khi ứng dụng xuất hiện, hãy thực hiện một lần kiểm tra cuối cùng. Tải ứng dụng xuống bất kỳ thiết bị thử nghiệm nào bạn có để đảm bảo rằng các tệp APK đang nhắm đến các thiết bị dự kiến. Xin chúc mừng! Bạn đã hoàn tất!