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. Việc phát hành nhiều tệp APK rất hữu ích nếu bạn hiện chưa phát hành ứng dụng lên Google Play, nhưng bạn phải tự xây dựng, 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 tệp APK trên Google Play, bạn cần áp dụng một số phương pháp hay ngay từ đầu và ngăn chặn những vấn đề không cần thiết trong quá trình phát triển. Bài học này sẽ chỉ cho bạn cách tạo nhiều tệp APK của ứng dụng, mỗi tệp APK có một phạm vi cấp độ API hơi khác nhau. Bạn cũng sẽ nhận được một số công cụ cần thiết để việc duy trì nhiều cơ sở mã APK trở nên dễ dàng 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ệ của nền tảng Android, tự nhiên bạn muốn ứng dụng của mình tận dụng được các tính năng mới trên thiết bị mới mà không phải hy sinh khả năng tương thích ngược. Ngay từ đầu, có vẻ như giải pháp tốt nhất là hỗ trợ nhiều APK, nhưng điều này thường không phải như vậy. Phần Sử dụng một tệp APK duy nhất trong hướng dẫn cho nhà phát triển nhiều tệp APK có cung cấp một số thông tin hữu ích về cách hoàn thành việc này bằng một tệp APK duy nhất, 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 dùng đến các kỹ thuật tính toán tốn kém như nội dung phản chiếu trong bài viết này.

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

  • Dễ dàng phát hành và kiểm thử hơn
  • Chỉ có một cơ sở mã duy nhất
  • Ứ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ị
  • Tính năng khôi phục ứng dụng trên các thiết bị vẫn hoạt động
  • Bạn không phải lo lắng về mức độ ưu tiên của thị trường, hành vi từ việc "nâng cấp" từ APK này lên APK tiếp theo hay APK nào sẽ đi kèm 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ủ đề, chuyên sâu nghiên cứu tài liệu trong các tài nguyên được liên kết và xác định rằng nhiều APK là đường dẫn phù hợp cho ứng dụng của bạn.

Lập biểu đồ các yêu cầu của bạn

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 tệp APK bạn cần cũng như phạm vi API mà mỗi tệp APK bao gồm. Để bạn có thể tham khảo thuận tiện, 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ác thiết bị đang hoạt động chạy một phiên bản nền tảng Android nhất định. Ngoài ra, mặc dù thoạt đầu nghe có vẻ dễ dàng, nhưng việc theo dõi tập hợp cấp độ API nào mà mỗi APK sẽ nhắm mục tiêu khá khó khăn và nhanh chóng, đặc biệt là nếu có một số trùng lặp (thường là). Thật may là bạn có thể dễ dàng xác định nhanh chóng các yêu cầu của mình và dễ dàng tham khảo để xem sau.

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

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

Giờ đây, bạn chỉ cần chọn màu trong biểu đồ, sao cho mỗi màu đại diện cho một tệp 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 bạn tạo biểu đồ này, hãy phân phối biểu đồ cho nhóm của mình. Hoạt động giao tiếp 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 "APK cho API cấp 3 đến 6 thế nào, bạn biết đấy, Android 1.x một. Mọi việc thế nào rồi?" Bạn chỉ cần nói "APK màu xanh dương có đến từ đâu không?"

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

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

Lưu ý: Mặc dù chi tiết triển khai về cách tạo và thêm dự án thư viện nằm ngoài phạm vi của bài học này, nhưng bạn có thể tăng tốc bằng cách đọc nội dung 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 cơ sở mã của 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 không thay đổi trong các tệp APK rồi đưa tất cả vào dự án thư viện. Mã không thay đổi nhiều cũng sẽ được đưa vào dự án thư viện. Có thể bạn sẽ phải 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 nhiều nhất có thể, sau đó chỉ chuyển mã xuống một APK riêng lẻ nếu cần. Điều này sẽ dễ quản lý về lâu dài hơn nhiều so với việc thêm blob này vào một, rồi đến một lần khác, rồi nhiều tháng sau đó cố gắng tìm hiểu xem liệu blob này có thể được di chuyển lên phần thư viện mà không cần sửa đổi bất cứ điều gì hay không.

Tạo dự án APK mới

Nên có một dự án Android riêng cho từng APK mà bạn sẽ 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 liên quan vào 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 tên gói, mặc dù các tệp APK 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 đồ được mô tả trước đó, thì 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 tệp tham chiếu đến 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 hoạt động khởi động trong dự án thư viện sẽ giúp bạn có thể đưa tất cả hoạt động khởi chạy ứng dụng của mình vào cùng một nơi để mỗi tệp APK riêng lẻ không phải triển khai lại các tác vụ "chung" như khởi chạy Analytics, chạy các bước 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 sang APK.

Đ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 thông qua Google Play, hệ thống sẽ chọn đúng tệp APK cần dùng qua 2 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 APK đủ điều kiện, số phiên bản cao nhất sẽ chiến thắng

Ví dụ: hãy cùng lấy tập hợp nhiều tệp APK được mô tả trước đó và giả định rằng chúng ta chưa đặt cấp độ API tối đa cho bất kỳ tệp APK nào. Khi thực hiện riêng từng tệp APK, phạm vi có thể có của mỗi tệp 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ì tệp APK có minSdkVersion cao hơn bắt buộc phải có mã phiên bản cao hơn, nên chúng tôi biết rằng xét theo giá trị versionCode, 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ả dưới dạng 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 thì không. Trang Bộ lọc trên Google Play trong Hướng dẫn cho nhà phát triển Android có toàn bộ danh sách các nguyên nhân có thể xảy ra. 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 mấu chốt của APK màu đỏ là kết hợp camera mặt trước với chức năng mới thú vị đã được thêm vào API 11. Tuy nhiên, hoá ra không phải thiết bị nào hỗ trợ API 11 cũng đều CÓ máy ảnh mặt trước! Thật kinh dị!

May mắn là nếu người dùng đang duyệt Google Play từ một thiết bị như vậy, Google Play sẽ xem xét các tệp kê khai, thấy rằng Red liệt kê yêu cầu về camera mặt trước và lặng lẽ bỏ qua yêu cầu đó, sau khi xác định rằng Red và thiết bị đó không phải là một kết hợp hoàn hảo trên thiên đường kỹ thuật số. Sau đó, 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 đượ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ì bất chấp toàn bộ rủi ro xảy ra với máy ảnh trước, vẫn có một tệp APK hỗ trợ cấp độ API cụ thể đó.

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

Xanh lam: 03001, 03002, 03003, 03004...
Màu xanh lục: 07001, 07002, 07003, 07004...
Màu đỏ:11001, 11002, 11003, 11004...

Kết hợp tất cả lại với nhau, 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 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. Hãy nhớ rằng các lỗi này có liên quan cụ thể đến nhiều APK và không hề thể hiện danh sách kiểm tra hoàn chỉnh cho tất cả ứng dụng được tải lên Google Play.

  • Tất cả APK phải có cùng tên gói
  • Tất cả APK đều phải được ký bằng cùng một chứng chỉ
  • Nếu các tệp APK trùng lặp trong 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 của bạn để tìm thông tin xung đột (APK chỉ hỗ trợ cupcake trên màn hình XLARGE sẽ không hiển thị cho bất kỳ ai)
  • Tệp kê khai của mỗi APK phải là duy nhất trên ít nhất một trong số các phiên bản màn hình, kết cấu OpenGL hoặc nền tảng được hỗ trợ
  • Thử thử nghiệm từng tệp APK trên ít nhất một thiết bị. Ngoài ra, bạn còn có một trong những trình mô phỏng thiết bị dễ tuỳ chỉnh nhất trên cỗ máy phát triển của mình. Câu đố thôi!

Bạn cũng nên kiểm tra APK đã biên dịch trước khi phát hành ra thị trường, để đảm bảo không có bất kỳ sự bất ngờ nào 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 bằng cách 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 xây dựng để tạo và đóng gói ứng dụng Android, đồng thời cũng là công cụ rất tiện dụng để kiểm tra chú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 bạn kiểm tra đầu ra aapt, hãy nhớ kiểm tra để chắc chắn rằng 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, đồng thời không có các giá trị "uses-feature" ngoài ý muốn được thêm vào do các quyền bạn đặt trong tệp kê khai. Trong ví dụ trên, APK sẽ không hiển thị cho rất nhiều thiết bị.

Tại sao? Bằng cách thêm quyền bắt buộc GỬI_SMS, yêu cầu tính năng của android.hardware.telephony đã được hoàn toàn thêm vào. Vì API 11 là Honeycomb (phiên bản Android được tối ưu hoá dành 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 trong đó nên Google Play sẽ lọc ra 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À sở hữu phần cứng điện thoại.

Rất may là bạn có thể dễ dàng khắc phục vấn đề này bằng cách thêm đoạn mã 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ếu muốn APK của mình hiển thị trên TV là thiết bị không phải màn hình cảm ứng, bạn nên thêm đoạn mã sau vào tệp kê khai:

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

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