Ngân sách bộ nhớ của ứng dụng cho phép ứng dụng đặt giới hạn mềm về dung lượng bộ nhớ mà ứng dụng lưu giữ. Khi ứng dụng của bạn vượt quá ngân sách, hệ thống sẽ không chấm dứt ứng dụng. Thay vào đó, hệ thống sẽ thu hồi bộ nhớ mà ứng dụng của bạn không sử dụng gần đây, nhờ đó ứng dụng của bạn giữ lại tập hợp hoạt động (bộ nhớ mà ứng dụng cần cho những việc người dùng đang làm) và trả lại phần còn lại cho thiết bị.
Ngân sách hữu ích nhất khi bạn biết tập hợp hoạt động của ứng dụng và muốn kiểm soát mức sử dụng bộ nhớ của ứng dụng, chẳng hạn như đối với các ứng dụng hệ thống và ứng dụng đi kèm hoặc đối với các ứng dụng nhắm đến thiết bị có bộ nhớ thấp.
Trang này bao gồm các chủ đề sau:
- Cách hoạt động của ngân sách bộ nhớ: tìm hiểu điều gì sẽ xảy ra khi ứng dụng của bạn vượt quá ngân sách.
- Khai báo ngân sách trong tệp kê khai Android: đặt ngân sách trạng thái ổn định cho từng trạng thái quy trình. Đây là phương pháp nên dùng.
- API thời gian chạy: truy vấn mức sử dụng, thắt chặt ngân sách trong thời gian chạy và theo dõi áp lực bộ nhớ từ Kotlin hoặc Java.
- Hiệu chỉnh, thử nghiệm và phát hành ngân sách: tìm ngân sách phù hợp cho ứng dụng, thử nghiệm và phát hành ngân sách theo từng giai đoạn.
Cách hoạt động của ngân sách bộ nhớ
Ngân sách được giữ cân bằng bằng cách sử dụng hoạt động hoán đổi và loại bỏ bộ nhớ để xoá các trang bộ nhớ không được dùng gần đây, tập trung mức sử dụng bộ nhớ của ứng dụng vào tập hợp hoạt động hiện tại. Khi một ứng dụng vượt quá ngân sách đã khai báo, hệ điều hành sẽ nhắm mục tiêu thu hồi cụ thể vào ứng dụng đó:
- Các trang được hỗ trợ tệp sạch (chẳng hạn như mã không hoạt động và tài sản được liên kết) sẽ bị loại bỏ trước tiên vì có thể đọc lại từ bộ nhớ nếu cần.
- Các trang được hỗ trợ tệp bẩn được ghi lại vào bộ nhớ và bị loại bỏ.
- Các trang bộ nhớ ẩn danh (chẳng hạn như phân bổ vùng nhớ khối xếp) được nén và hoán đổi sang zRAM.
Việc thu hồi sẽ tạo không gian cho các lượt phân bổ mới và giữ cho mức sử dụng bộ nhớ của ứng dụng nằm trong ngân sách.
Miễn là có khoảng trống giữa những gì ứng dụng cần tại bất kỳ thời điểm nào (tập hợp đang hoạt động) và ngân sách đã đặt, ứng dụng sẽ tiếp tục chạy bình thường. Nếu một ứng dụng đặt ngân sách nhỏ hơn nhóm hoạt động, thì hiệu suất của ứng dụng đó trong thời gian chạy có thể bị chậm lại.
Để tìm hiểu cách hệ điều hành theo dõi và thu hồi bộ nhớ, hãy xem hướng dẫn về cấu trúc bộ nhớ:
- Thu hồi và hoán đổi bộ nhớ: Giải thích cách hệ điều hành tính phí các trang được sao lưu tệp và vùng nhớ khối xếp ẩn danh riêng tư cho ứng dụng của bạn, đồng thời thu hồi các trang không hoạt động khi vượt quá ngân sách.
- Khái niệm cơ bản: Giải thích lý do bộ nhớ Zygote dùng chung bị loại trừ khỏi ngân sách của ứng dụng và mối liên hệ giữa ngân sách thường trú với RSS ẩn danh + hoán đổi trong dữ liệu đo từ xa tại trường.
- Bitmap và bộ nhớ: Giải thích cách bitmap phần cứng và mức phân bổ DMA-BUF do GPU hỗ trợ được tính bên ngoài vùng nhớ khối xếp và ngân sách bộ nhớ của ứng dụng.
Khai báo ngân sách trong tệp kê khai Android
Sử dụng AndroidManifest.xml để khai báo ngân sách bộ nhớ ở trạng thái ổn định,
đây là ngân sách cơ sở mà ứng dụng của bạn hoạt động trong quá trình sử dụng bình thường.
Khai báo tệp kê khai không yêu cầu mã thời gian chạy, có hiệu lực khi khởi động quy trình và chuyển đổi ngân sách giữa các trạng thái foreground, perceptible và background. PackageManager.getMemoryBudgets hiển thị các khai báo ngân sách tĩnh <application>. Để kiểm thử ngân sách và phát hành ngân sách bằng tính năng khôi phục từ xa trước khi đưa ngân sách vào tệp kê khai, hãy xem bài viết Hiệu chỉnh, kiểm thử và phát hành ngân sách.
Nội dung khai báo <memory-budget> có hiệu lực trên các thiết bị chạy Android 17 QPR2 (cấp độ API 37.2) trở lên. Trên các phiên bản Android thấp hơn, trình phân tích cú pháp tệp kê khai nền tảng sẽ bỏ qua các phần tử XML không nhận dạng được, vì vậy, bạn có thể sử dụng <memory-budget> mà không ảnh hưởng đến khả năng tương thích ngược.
Định cấu hình bản dựng
Bạn không cần tăng minSdk hoặc targetSdk để áp dụng ngân sách bộ nhớ của ứng dụng.
Để khai báo ngân sách cho mỗi quy trình trong <processes>, bạn cần có trình bổ trợ Android cho Gradle phiên bản 9.5.0 trở lên. Để biên dịch các thuộc tính tệp kê khai <memory-budget>,
MemoryBudgetManager và
Build.VERSION_CODES_FULL.CINNAMON_BUN_2, hãy đặt compileSdk thành cấp độ API 37
bằng minorApiLevel = 2 trong tệp build.gradle.kts hoặc build.gradle
của mô-đun:
Kotlin
android {
compileSdk {
version = release(37) {
minorApiLevel = 2
}
}
}
Groovy
android {
compileSdk {
version = release(37) {
it.minorApiLevel = 2
}
}
}
Khai báo ngân sách cơ sở
Đối với hầu hết ứng dụng, bạn chỉ cần xác định một ngân sách duy nhất cho ứng dụng. Khai báo một phần tử <memory-budget> ngay bên trong thẻ <application>:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.simpleapp">
<application
android:label="@string/app_name">
<!-- Baseline budget for the application -->
<memory-budget android:maxMb="256" />
</application>
</manifest>
Thao tác này sẽ đặt ngân sách bộ nhớ thường trú 256 MB cho tất cả các quy trình và trạng thái của gói. Khi mức sử dụng bộ nhớ của ứng dụng vượt quá 256 MB, hệ điều hành sẽ cắt bớt các trang bộ nhớ không hoạt động bằng cách loại bỏ và hoán đổi.
Thay đổi ngân sách theo trạng thái quy trình
Ứng dụng cần lượng bộ nhớ khác nhau tuỳ thuộc vào chế độ hiển thị của người dùng:
- Nền trước: Tiến trình đang lưu trữ một Hoạt động hiển thị tương tác với người dùng. Trạng thái này thường có mức sử dụng bộ nhớ lớn nhất do giao diện người dùng và đồ hoạ đang hoạt động.
- Dễ nhận biết: Người dùng có thể nhận biết được quy trình nhưng quy trình này không lưu trữ cửa sổ hiển thị (ví dụ: lưu trữ dịch vụ nền trước phát nội dung nghe nhìn, tải xuống trong nền đang hoạt động, đường đi từng chặng hoặc phương thức nhập đang hoạt động).
- Nền: Quy trình đang chạy các công việc, trình nhận hoặc đồng bộ hoá dữ liệu trong nền. Thư viện này dự kiến sẽ duy trì mức sử dụng tài nguyên tối thiểu.
Bạn có thể khai báo nhiều mệnh đề <memory-budget> để khớp với các trạng thái sau:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.simpleapp">
<application
android:label="@string/app_name">
<!-- Default budget for visible foreground UI -->
<memory-budget android:maxMb="200" />
<!-- Tighter budget when playing audio in background -->
<memory-budget
android:maxMb="120"
android:state="perceptible" />
<!-- Minimal budget when fully in background -->
<memory-budget
android:maxMb="48"
android:state="background" />
</application>
</manifest>
Bạn không cần phải có mệnh đề nền trước hoặc mệnh đề trạng thái bị bỏ qua. Nếu bạn chỉ khai báo các mệnh đề perceptible hoặc background, thì các trạng thái có mức độ quan trọng cao hơn như foreground vẫn không bị ràng buộc bởi ngân sách ứng dụng. Nếu bạn bỏ qua android:state, thì trạng thái mặc định sẽ là foreground, trạng thái này sẽ chuyển sang perceptible và background, trừ phi một mệnh đề sau đó ghi đè các trạng thái đó. Để biết thông tin chi tiết về thứ tự mệnh đề, hãy xem phần Quy tắc giải quyết: mệnh đề áp dụng gần đây nhất sẽ có hiệu lực.
Khi định cỡ ngân sách cho từng trạng thái, hãy nhắm đến tập hợp hoạt động của trạng thái đó thay vì bộ nhớ thường trú cao nhất (mức cao nhất của RSS):
- Kích thước
foregroundngân sách để kết xuất khung hình mượt mà: Cung cấp cho giao diện người dùng trên nền trước đủ không gian cho tập hợp hoạt động của giao diện người dùng để việc thu hồi đồng bộ không làm chậm quá trình kết xuất khung hình. Nếu ứng dụng của bạn có một quy trình làm việc độc lập cần nhiều bộ nhớ (chẳng hạn như trình chỉnh sửa hình ảnh hoặc video có độ phân giải cao), hãy cân nhắc chuyển hoạt động đó sang một quy trình chuyên biệt (xem phần Ứng dụng đa quy trình) để các lượt phân bổ được lập ngân sách độc lập và bị huỷ khi người dùng thoát. - Đặt ngân sách
backgroundchặt chẽ cho công việc không có giao diện người dùng: RSS nền cao trong dữ liệu đo từ xa tại hiện trường thường phản ánh các lượt phân bổ giao diện người dùng được giữ lại sau khi rời khỏi nền trước (xem phần Đồng định vị dịch vụ ràng buộc với giao diện người dùng cần nhiều bộ nhớ và Giải phóng bộ nhớ để phản hồi các sự kiện) hoặc các lượt đọc tệp một lần trong quá trình lập chỉ mục và đồng bộ hoá trong nền. Vì công việc chạy trong nền không có thời hạn khung, nên việc loại bỏ các trang bộ nhớ đệm tệp một lần và hoán đổi các trang vùng nhớ khối xếp không hoạt động sang zRAM khi quá trình đồng bộ hoá trong nền phân bổ một thời gian ngắn vượt quá ngân sách sẽ không gây ra hiện tượng giật mà người dùng nhìn thấy được, đồng thời ngăn chặn các mức tăng đột biến trong nền loại bỏ ứng dụng trên nền trước của người dùng.
Để biết quy trình từng bước, hãy xem bài viết Hiệu chỉnh ngân sách.
Cách trạng thái ngân sách liên kết với trạng thái quy trình
Nền tảng này liên kết các trạng thái ngân sách trong tệp kê khai với các trạng thái quy trình trong thời gian chạy dựa trên RunningAppProcessInfo.importance. Trình quản lý hoạt động sẽ tính toán các trạng thái này từ cả thành phần đang hoạt động của chính quy trình đó và mọi liên kết dịch vụ hoặc truy vấn của nhà cung cấp nội dung từ các ứng dụng khác:
foreground: Các hoạt động tương tác đang hoạt động, hiển thị của người dùng, chẳng hạn như lưu trữ một Hoạt động đã tiếp tục, duy trì trạng thái ứng dụng hàng đầu khi màn hình tắt hoặc lưu trữ một dịch vụ hoặc nhà cung cấp nội dung được ứng dụng trên nền trước hàng đầu liên kết hoặc truy vấn một cách chủ động.perceptible: Khối lượng công việc mà người dùng có thể nhận thấy mà không có cửa sổ hiển thị, chẳng hạn như phát nội dung nghe nhìn đang hoạt động, chỉ đường từng chặng, chụp ảnh bằng camera hoặc ghi âm bằng micrô, tải xuống trong nền đang hoạt động, dịch vụ đồng bộ hoá dữ liệu trên nền trước hoặc dịch vụ liên kết với ứng dụng nền trước bằng cách sử dụng các cờ nhưBIND_NOT_FOREGROUND(xem phần Kiểm soát tính kế thừa bằng cờ BIND). Mặc dù các chỉ số nền tảng nội bộ có thể gắn nhãn một số khối lượng công việc nàyPROCESS_STATE_IMPORTANT_FOREGROUND, nhưng hằng số nội bộ đó không biểu thị một cửa sổ hiển thị và chịu sự điều chỉnh của ngân sáchperceptible.background: Công việc mà người dùng không nhận thấy ngay lập tức, chẳng hạn như công việc trong nền, chuông báo và bộ nhận tín hiệu truyền tin.
Bảng sau đây cho biết cách các mức độ quan trọng trong thời gian chạy liên kết với trạng thái tệp kê khai:
Tệp kê khai android:state |
Tầm quan trọng của thời gian chạy (RunningAppProcessInfo) |
Các thành phần điển hình |
|---|---|---|
foreground |
IMPORTANCE_FOREGROUNDIMPORTANCE_TOP_SLEEPING |
Hoạt động hiển thị đã tiếp tục, ứng dụng trên cùng có phương thức khoá màn hình, dịch vụ hoặc trình cung cấp nội dung bị ràng buộc bởi ứng dụng trên cùng |
perceptible |
IMPORTANCE_FOREGROUND_SERVICEIMPORTANCE_VISIBLE |
Dịch vụ nền trước đang phát nội dung nghe nhìn, điều hướng, tải xuống hoặc đồng bộ hoá; dịch vụ liên kết với cờ dịch vụ nền trước hoặc cờ hiển thị |
background |
IMPORTANCE_PERCEPTIBLEIMPORTANCE_CANT_SAVE_STATEIMPORTANCE_SERVICEIMPORTANCE_CACHED |
Công việc trong nền, trình nhận, đồng bộ hoá trong nền và quy trình được lưu vào bộ nhớ đệm |
Để biết thông tin chi tiết về cách các liên kết ứng dụng nâng cao quy trình lưu trữ của dịch vụ hoặc nhà cung cấp và cách quy trình chuyển đổi trở lại background hoặc cached sau khi ứng dụng huỷ liên kết hoặc di chuyển ra khỏi màn hình, hãy xem phần Liên kết dịch vụ và trạng thái quy trình.
Khi một quy trình chuyển sang trạng thái đã lưu vào bộ nhớ đệm (IMPORTANCE_CACHED) mà không có thành phần nào đang hoạt động, nền tảng sẽ tiếp tục thực thi ngân sách bộ nhớ background cùng với việc đóng băng và thu hồi quy trình đã lưu vào bộ nhớ đệm, giữ cho quy trình được giới hạn ngay cả khi không xảy ra hiện tượng đóng băng hoặc nén.
Kiểm tra trạng thái và ngân sách của quy trình ứng dụng
Một cách để kiểm tra trạng thái và tầm quan trọng của quy trình hoạt động trong ứng dụng trong quá trình phát triển là truy vấn Trình quản lý hoạt động bằng ADB:
adb shell dumpsys activity processes <package-name>
Ví dụ tóm tắt sau đây cho thấy bản ghi quy trình và các mục kiểm soát OOM cho một ứng dụng đang chạy dịch vụ nền trước:
ACTIVITY MANAGER RUNNING PROCESSES (dumpsys activity processes)
All known processes:
*APP* UID 10123 ProcessRecord{edf056c 3919:com.example.app/u0a123}
pid=3919
oom adj: max=1001 curRaw=200 setRaw=200 cur=200 set=200
curProcState=4 mRepProcState=4 setProcState=4 lastStateTime=-42s360ms
hasStartedServices=true
mHasForegroundServices=true forcingToImportant=null
...
Process OOM control (48 total):
Proc #22: prcp F/S/FGS ---NFU-TI t: 0 3919:com.example.app/u0a123 (fg-service)
oom: max=1001 curRaw=200 setRaw=200 cur=200 set=200
state: cur=FGS set=FGS lastRss=0.00 lastCachedRss=0.00
Trong kết quả này:
curProcState=4vàstate: cur=FGScho biết quy trình đang ở trạng thái dịch vụ nền trước. Nếu ứng dụng của bạn đang lưu trữ một hoạt động hiển thị đang hoạt động, thì hoạt động này sẽ xuất hiện dưới dạngTOP. Nếu đang chạy một thành phần quan trọng trên nền trước (chẳng hạn như tải xuống hoặc đồng bộ hoá), thì ứng dụng sẽ xuất hiện dưới dạngIMPF.- Trong bảng điều khiển OOM của quy trình,
prcpcho biết quy trình được đánh giá theo cấp độ ưu tiên có thể nhận biết, tương ứng với ngân sáchperceptible.
Cách kiểm tra mức sử dụng bộ nhớ thường trú hiện tại của ứng dụng:
adb shell dumpsys meminfo <package-name>
Ứng dụng đa quy trình
Nếu ứng dụng của bạn chia công việc thành nhiều quy trình, hãy định cấu hình ngân sách quy trình chuyên dụng bằng thẻ <process> bên trong <processes>.
Ví dụ: hãy xem xét một ứng dụng phát nhạc trực tuyến (com.example.radio):
- Quy trình chính: Lưu trữ giao diện người dùng hiển thị và công cụ phát âm thanh (
MediaSessionServicecó dịch vụ nền trướcmediaPlayback). Khi hiển thị, quy trình này hoạt động trong phạm vi ngân sách 180 MB cho ứng dụng chạy trên nền trước. Khi người dùng rời khỏi ứng dụng trong khi nhạc vẫn tiếp tục phát, quy trình sẽ chuyển sang trạng tháiperceptible, trong đó ngân sách 64 MB là đủ cho công cụ phát và vùng đệm âm thanh. - Quy trình đồng bộ hoá (
:sync): Quy trình chuyên biệt chạy quá trình đồng bộ hoá siêu dữ liệu trong nền và lập chỉ mục nội dung tải xuống. Vì quy trình này chỉ hoạt động ở chế độ nền, nên bạn không cần khai báo rõ ràngstate="background"; một ngân sách duy nhất sẽ được áp dụng.
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.radio">
<application
android:label="@string/app_name">
<!-- Package baseline: main process with UI and audio playback -->
<memory-budget android:maxMb="180" />
<!-- Tighter budget when audio plays in the background -->
<memory-budget
android:maxMb="64"
android:state="perceptible" />
<processes>
<!-- Dedicated background sync process -->
<process android:process=":sync">
<memory-budget android:maxMb="32" />
</process>
</processes>
<service
android:name=".playback.AudioPlayerService"
android:foregroundServiceType="mediaPlayback"
android:exported="false" />
<service
android:name=".sync.PlaylistSyncService"
android:process=":sync"
android:exported="false" />
</application>
</manifest>
Khi bạn khai báo một khối <processes> trong tệp kê khai, hãy chỉ liệt kê các mục <process> cho những quy trình khai báo <memory-budget>. Nếu chỉ muốn đặt ngân sách cho một số quy trình con cụ thể trong khi vẫn giữ nguyên phần còn lại của ứng dụng ở giới hạn hệ thống cho thiết bị, bạn có thể bỏ qua các phần tử <memory-budget> ngay dưới <application>.
Mức sử dụng bộ nhớ trong bất kỳ quy trình con nào đều được tính vào cả ngân sách quy trình và ngân sách gói bao quanh. Một quy trình sẽ gặp phải áp lực bộ nhớ trong thời gian chạy nếu quy trình đó vi phạm ngân sách quy trình hoặc ngân sách gói, tuỳ theo ngưỡng nào đạt được trước.
Điều chỉnh ngân sách cho màn hình có mật độ điểm ảnh cao
Đối với những ứng dụng có mức sử dụng bộ nhớ tăng đáng kể theo số lượng pixel cần vẽ tại một thời điểm (chẳng hạn như ứng dụng thư viện ảnh lưu bitmap vào bộ nhớ đệm theo kích thước cửa sổ), Android cung cấp hai cơ chế thay thế để điều chỉnh ngân sách một cách linh động theo thông số kỹ thuật của màn hình:
Điều chỉnh theo nhóm mật độ hiển thị (
android:additionalMbPerDensity): Thêm megabyte theo tỷ lệ bình phương của tỷ lệ mật độ của màn hình so vớimdpi(1,0x/160 dpi), vì các thành phần giao diện người dùng và đối tượng có thể vẽ dạng đường quét 2D điều chỉnh theo cả chiều rộng và chiều cao:<!-- Baseline 180MB + 16MB multiplied by (density ratio)^2 --> <memory-budget android:maxMb="180" android:additionalMbPerDensity="16" />Trên màn hình
mdpi(1.0x), ngân sách là 180 + 16 × 12 = 196 MB. Trên màn hìnhxxhdpi(3.0x), ngân sách tăng lên 180 + 16 × 32 = 324 MB.Điều chỉnh theo số lượng pixel của cửa sổ (
android:additionalBytesPerDisplayPixel): Thêm byte trên mỗi pixel trong ranh giới cửa sổ đang hoạt động (WindowMetrics.getBoundschiều rộng × chiều cao). Điều này phù hợp với các ứng dụng phân bổ nền tảng đồ hoạ toàn cửa sổ, vùng đệm kết xuất hoặc bộ nhớ đệm ảnh có độ phân giải cao, trong đó mức tiêu thụ bộ nhớ tăng theo tỷ lệ trực tiếp với số lượng pixel thô thay vì nhóm mật độ giao diện người dùng:<!-- Baseline 128MB + 16 bytes per window pixel --> <!-- For example, a 4-byte RGBA full-window buffer with double or quadruple buffering --> <memory-budget android:maxMb="128" android:additionalBytesPerDisplayPixel="16" />Trên cửa sổ 1080p toàn màn hình (1080 × 2400 ≈ 2,59 triệu pixel), thao tác này sẽ thêm 41.472.000 byte (≈ 39,6 MB, trong đó 1 MB = 1.048.576 byte) vào ngân sách cơ sở. Trên cửa sổ 1440p (1440 × 3120 ≈ 4,49 triệu pixel), thao tác này sẽ thêm 71.884.800 byte (≈ 68,6 MB).
Hai thuộc tính này có thể thay thế cho nhau. Chọn thuộc tính phù hợp với hệ số tỷ lệ chính của ứng dụng và tránh kết hợp cả hai trong cùng một mệnh đề.
Chuyên biệt hoá cho các kiểu dáng thiết bị
Khi cung cấp tệp APK trên điện thoại, máy tính bảng và Wear OS, hãy sử dụng thuộc tính android:feature để điều chỉnh ngân sách cho các mục tiêu phần cứng khác nhau.
Trên đồng hồ Wear OS, RAM bị hạn chế, đồng thời giao diện người dùng và tập hợp tính năng của ứng dụng cũng đơn giản hơn nhiều. Bạn có thể khai báo ngân sách chặt chẽ hơn dành riêng cho tính năng watch:
<!-- General phone and tablet baseline -->
<memory-budget android:maxMb="180" />
<!-- Wear OS override: simpler UI and constrained hardware -->
<memory-budget
android:maxMb="48"
android:feature="watch" />
Quy tắc giải quyết: điều khoản áp dụng cuối cùng sẽ có hiệu lực
Khi xác định nhiều phần tử <memory-budget> cho một ứng dụng hoặc quy trình, hệ thống sẽ đánh giá các phần tử đó theo thứ tự xuất hiện trong tệp kê khai và thực thi mệnh đề ngân sách áp dụng gần đây nhất.
android:state bị bỏ qua sẽ mặc định là foreground, cũng như xếp tầng thành perceptible và background trừ phi bị ghi đè bởi một mệnh đề sau đó cho các trạng thái đó. Sắp xếp các mệnh đề từ foreground (hoặc bỏ qua android:state) đến perceptible đến background, đồng thời đặt các chế độ ghi đè android:feature trong nhóm trạng thái phù hợp để chế độ ghi đè trạng thái bị bỏ qua ở cuối không che khuất các mệnh đề perceptible hoặc background trước đó.
Tài liệu tham khảo về thuộc tính XML
Tất cả thuộc tính megabyte (MB) đều sử dụng đơn vị nhị phân (1 MB = 1.048.576 byte) và liên kết với mức phí memory.current của cgroup Linux (không bao gồm bộ nhớ dùng chung từ Zygote).
| Thuộc tính | Định dạng | Mặc định | Mô tả |
|---|---|---|---|
android:maxMb |
Số nguyên (> 0) | Bắt buộc | Giới hạn ngân sách bộ nhớ thường trú cơ sở tính bằng MB. |
android:state |
Enum | foreground |
Trạng thái quy trình mà ngân sách này áp dụng: foreground, perceptible hoặc background. Nếu bạn bỏ qua, thì giá trị mặc định sẽ là foreground và áp dụng cho perceptible và background, trừ phi bị ghi đè bằng một mệnh đề sau đó. |
android:additionalMbPerDensity |
Số nguyên (≥ 0) | 0 |
Số megabyte bổ sung nhân với bình phương của tỷ lệ mật độ hiển thị so với mdpi (1,0 lần). |
android:additionalBytesPerDisplayPixel |
Số nguyên (≥ 0) | 0 |
Số byte bổ sung được phân bổ cho mỗi pixel cửa sổ (WindowMetrics.getBounds chiều rộng × chiều cao), hữu ích cho vùng đệm bề mặt và bitmap. |
android:feature |
Chuỗi | Khán giả có | Giới hạn mệnh đề đối với các thiết bị khai báo các tính năng phần cứng cụ thể: watch, automotive hoặc leanback. |
API thời gian chạy
Bên cạnh các mệnh đề khai báo trong tệp kê khai <memory-budget>, Android còn cung cấp một API SDK thời gian chạy cho các tác vụ sau:
- Xác thực ngân sách đề xuất sau cấu hình từ xa trước khi cam kết ngân sách đó với
AndroidManifest.xml, như mô tả trong phần Phát hành ngân sách theo giai đoạn. - Truy vấn mức sử dụng bộ nhớ cgroup trực tiếp và ngân sách hiệu quả trong quá trình.
- Thắt chặt ngân sách của một quy trình hoặc gói một cách linh động trong các tác vụ nhẹ.
- Theo dõi các sự kiện vượt quá ngân sách để cắt bớt bộ nhớ đệm khi hệ điều hành thu hồi bộ nhớ.
API SDK Android (MemoryBudgetManager)
Dịch vụ hệ thống MemoryBudgetManager được cung cấp cho các ứng dụng viết bằng Kotlin và Java kể từ Android 17 QPR2 (bản phát hành SDK nhỏ, cấp độ API 37.2/Build.VERSION_CODES_FULL.CINNAMON_BUN_2).
Truy xuất dịch vụ
Trước khi truy cập vào MemoryBudgetManager, hãy kiểm tra để đảm bảo thiết bị chạy Android 17 QPR2 trở lên bằng cách kiểm tra SDK_INT_FULL. Nếu minSdk của ứng dụng thấp hơn 36, hãy kiểm tra SDK_INT trước để các Thiết bị chạy Android 15 (cấp độ API 35) trở xuống không gửi NoSuchFieldError khi đọc SDK_INT_FULL:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA &&
Build.VERSION.SDK_INT_FULL >= Build.VERSION_CODES_FULL.CINNAMON_BUN_2
) {
val budgetManager = context.getSystemService(MemoryBudgetManager::class.java)
}
Mức sử dụng và ngân sách truy vấn
// Query current memory charged to this process and the package UID
val processUsageBytes = budgetManager.processCurrentUsageBytes
val packageUsageBytes = budgetManager.packageCurrentUsageBytes
// Query process-scope and package-scope limits (LIMIT_IS_DISABLED if unset)
val processBudgetBytes = budgetManager.processBudgetBytes
val packageBudgetBytes = budgetManager.packageBudgetBytes
Đặt hoặc xoá ngân sách một cách linh động
Bạn có thể đặt ngân sách chặt chẽ hơn trong thời gian chạy để hạn chế bộ nhớ trong các tác vụ nhẹ hoặc xoá ngân sách khi tác vụ kết thúc:
// Set a tighter dynamic budget on the current process (for example, 96 MB)
try {
budgetManager.processBudgetBytes = 96L * 1024L * 1024L
} catch (e: IllegalArgumentException) {
// Thrown if the budget is <= 0 or exceeds a manifest or system limit.
Log.e(TAG, "Requested budget exceeds manifest or system ceiling", e)
}
// Clear the dynamic process budget to restore the manifest limit (or unconstrained baseline)
budgetManager.clearProcessBudget()
Không giống như các mệnh đề trong tệp kê khai <memory-budget> (chỉ định các giới hạn riêng cho các trạng thái foreground, perceptible và background), một ngân sách động được đặt thông qua MemoryBudgetManager sẽ áp dụng một mức trần thời gian chạy duy nhất cho đến khi mã của bạn cập nhật hoặc xoá mức trần đó. Nếu bạn sử dụng API thời gian chạy để chạy thử nghiệm thực địa hoặc quản lý các giới hạn theo trạng thái cụ thể, hãy cập nhật hoặc xoá ngân sách động trong quá trình chuyển đổi vòng đời, chẳng hạn như thông qua lệnh gọi lại ProcessLifecycleOwner hoặc vòng đời của activity, như trong Ví dụ về trình chỉnh sửa hình ảnh thích ứng.
Hiệu suất và tính luỹ đẳng
Khi làm việc với MemoryBudgetManager trong thời gian chạy, hãy lưu ý các đặc điểm sau:
- Tính bất biến: Tất cả API thay đổi ngân sách đều có tính bất biến. Việc gọi
clearProcessBudget()hoặcclearPackageBudget()nhiều lần hoặc khi không có ngân sách động nào đang hoạt động là một thao tác an toàn. Tương tự, việc đặtsetProcessBudgetBytes()hoặcsetPackageBudgetBytes()thành cùng một giá trị liên tiếp sẽ không kích hoạt cấu hình lại hệ thống thừa. - Tần suất gọi: Việc đặt, cập nhật hoặc xoá ngân sách sẽ thực hiện lệnh gọi liên quy trình đến dịch vụ hệ thống để cập nhật bộ điều khiển bộ nhớ của hệ điều hành cho quy trình. Mặc dù nhẹ nhưng không hoàn toàn miễn phí. Gọi các API này trong quá trình chuyển đổi vòng đời riêng biệt và các mốc nhiệm vụ (chẳng hạn như vào hoặc rời khỏi một hoạt động, bắt đầu hoặc hoàn tất tiến trình nền hoặc xử lý yêu cầu lời nói) và tránh gọi các API này trong các vòng lặp hẹp, luồng xử lý âm thanh hoặc quy trình kết xuất theo khung hình.
- Tần suất truy vấn: Các thuộc tính truy vấn
processCurrentUsageBytes,packageCurrentUsageBytes,processBudgetBytesvàpackageBudgetBytesđọc giới hạn và mức sử dụng cgroup trực tiếp trong quá trình thông qua các lệnh gọi gốc cục bộ thay vì gọi dịch vụ hệ thống. Mặc dù các truy vấn này diễn ra nhanh, nhưng hãy gọi chúng theo yêu cầu (chẳng hạn như trong quá trình chuyển đổi tác vụ hoặc bên trong lệnh gọi lạiOnOverBudgetListener) thay vì thăm dò ý kiến trong các vòng lặp hẹp.
Theo dõi lệnh gọi lại về áp lực vượt quá ngân sách
Ứng dụng có thể đăng ký một trình nghe để nhận thông báo khi mức sử dụng bộ nhớ vượt quá ngưỡng ngân sách. Điều này cho phép ứng dụng chủ động dọn dẹp ở cấp ứng dụng (chẳng hạn như xoá bộ nhớ đệm bitmap trong bộ nhớ) trong khi hệ điều hành thu hồi bộ nhớ để giữ cho quy trình hoặc gói nằm trong ngân sách:
val cleanupThread = HandlerThread("MemoryBudgetCleanup").apply { start() }
val listener = MemoryBudgetManager.OnOverBudgetListener { budgetBytes ->
Log.w(TAG, "Process exceeded memory budget of $budgetBytes bytes")
// Proactively evict thread-safe caches on the background Looper
imageTileCache.evictAll()
}
// Register on a background Looper before tightening a dynamic budget
budgetManager.registerProcessOverBudgetListener(cleanupThread.looper, listener)
// When done (for example, in onStop)
budgetManager.unregisterProcessOverBudgetListener(listener)
Các phương pháp hay nhất cho lệnh gọi lại vượt quá ngân sách:
- Sử dụng nền
Looper: Chuyển nềnHandlerThreadLoopersangregisterProcessOverBudgetListenerhoặcregisterPackageOverBudgetListenerbất cứ khi nào có thể. Việc chạy quy trình loại bỏ bộ nhớ đệm hoặc dọn dẹp tệp trên một luồng nền sẽ tránh được xung đột với quá trình kết xuất khung hình trên luồng giao diện người dùng khi quy trình này chịu áp lực về bộ nhớ. Dành riêngLooper.getMainLoopercho trình nghe chỉ chạm vào trạng thái giao diện người dùng liên kết với luồng chính. - Dự kiến các lệnh gọi lại lặp lại: Lệnh gọi lại vượt quá ngân sách không phải là thông báo một lần. Khi mức sử dụng vượt quá ngân sách, hệ điều hành sẽ thu hồi các trang không hoạt động trước tiên. Nếu áp lực vẫn tiếp diễn, hệ thống sẽ tiếp tục thu hồi bộ nhớ và gọi trình nghe của bạn tối đa một lần mỗi giây. Hãy đảm bảo lệnh gọi lại của bạn có tính chất luỹ đẳng. Nếu ứng dụng của bạn chỉ cần một thông báo hoặc muốn có thời gian hồi chiêu lâu hơn giữa các lượt dọn dẹp, hãy gọi
unregisterProcessOverBudgetListener(hoặcunregisterPackageOverBudgetListener) bên trong lệnh gọi lại hoặc bảo vệ quá trình dọn dẹp bằng dấu thời gian hồi chiêu hoặcAtomicBoolean. - Đăng ký trước khi thắt chặt ngân sách: Nếu mức sử dụng bộ nhớ hiện tại đã vượt quá ngân sách mới khi bạn gọi
setProcessBudgetByteshoặcsetPackageBudgetBytes, thì sự kiện vượt quá ngân sách sẽ được kích hoạt ngay khi ngân sách mới được áp dụng. Đăng ký trình nghe trước khi đặt ngân sách để ứng dụng của bạn không bỏ lỡ thông báo vượt ngân sách ban đầu. - Nhanh chóng: Các thao tác thu hồi phải mang lại hiệu quả ngay lập tức. Các phép tính phức tạp trong thời gian áp lực sẽ làm giảm hiệu suất.
- Tránh phân bổ: Đừng phân bổ đối tượng mới hoặc bắt đầu luồng mới bên trong lệnh gọi lại, vì làm như vậy có thể kích hoạt ngay lập tức việc thu hồi trực tiếp của hệ điều hành.
- Tập trung vào các mục tiêu có hiệu suất cao: Việc loại bỏ các Bitmap lớn, vùng đệm kết xuất hoặc đóng các tệp được ánh xạ trong bộ nhớ sẽ hiệu quả hơn nhiều so với việc giải phóng nhiều đối tượng nhỏ.
Ví dụ về Runtime API
Ví dụ sau đây minh hoạ cách triển khai API thời gian chạy bằng API SDK Android trong Kotlin:
Ví dụ về SDK Android: Trình chỉnh sửa hình ảnh thích ứng
Ví dụ này cho thấy một ứng dụng chỉnh sửa hình ảnh (com.example.imageeditor) có tệp kê khai khai báo mức trần 256 MB để phù hợp với canvas nhiều lớp:
<manifest ... >
<application ... >
<!-- Manifest ceiling accommodates the heaviest editing workload -->
<memory-budget android:maxMb="256" />
</application>
</manifest>
Khi người dùng duyệt xem thư viện hình thu nhỏ gọn nhẹ, ứng dụng sẽ sử dụng API SDK Android trong Kotlin để thắt chặt ngân sách quy trình một cách linh động xuống còn 96 MB.
Khi người dùng mở canvas chỉnh sửa nhiều lớp, ứng dụng sẽ xoá ngân sách động để khôi phục toàn bộ giới hạn tệp kê khai 256 MB. Lớp này cũng đăng ký một
OnOverBudgetListener trên HandlerThread
Looper nền trước khi áp dụng ngân sách thư viện để loại bỏ các bitmap xem trước được lưu vào bộ nhớ đệm
khi có áp lực mà không chặn luồng giao diện người dùng.
package com.example.imageeditor.ui
import android.app.Activity
import android.app.MemoryBudgetManager
import android.graphics.Bitmap
import android.os.Bundle
import android.os.HandlerThread
import android.util.Log
import android.util.LruCache
class ImageEditorActivity : Activity() {
private lateinit var budgetManager: MemoryBudgetManager
private lateinit var cleanupThread: HandlerThread
// Thread-safe in-memory cache for rendered preview tiles (32MB limit)
private val previewCache = object : LruCache<String, Bitmap>(32 * 1024 * 1024) {
override fun sizeOf(key: String, value: Bitmap): Int = value.byteCount
}
private val overBudgetListener = MemoryBudgetManager.OnOverBudgetListener { budgetBytes ->
Log.w(TAG, "Process memory pressure detected (budget: ${budgetBytes / 1048576}MB). Evicting preview cache.")
previewCache.evictAll()
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
budgetManager = getSystemService(MemoryBudgetManager::class.java)
cleanupThread = HandlerThread("MemoryBudgetCleanup").apply { start() }
}
override fun onStart() {
super.onStart()
// Register listener on a background Looper before tightening the budget
budgetManager.registerProcessOverBudgetListener(cleanupThread.looper, overBudgetListener)
// Constrain memory during lightweight gallery browsing
applyGalleryBudget()
}
override fun onStop() {
super.onStop()
budgetManager.unregisterProcessOverBudgetListener(overBudgetListener)
// Clear the activity-scoped gallery budget when leaving the activity.
budgetManager.clearProcessBudget()
}
override fun onDestroy() {
cleanupThread.quitSafely()
super.onDestroy()
}
/**
* Called when the user enters the high-resolution editing canvas.
* Clears the dynamic budget, restoring the full 256MB manifest ceiling.
*/
fun enterEditingCanvas() {
// Clear the tighter dynamic budget to restore the full manifest ceiling (256MB)
budgetManager.clearProcessBudget()
Log.i(TAG, "Restored manifest budget ceiling (256MB) for editing canvas")
}
/**
* Called when the user exits the editor back to the thumbnail gallery.
* Re-applies the tighter dynamic budget.
*/
fun exitToGallery() {
previewCache.trimToSize(8 * 1024 * 1024)
applyGalleryBudget()
}
private fun applyGalleryBudget() {
try {
// Dynamically tighten budget to 96MB for the lightweight gallery view
budgetManager.processBudgetBytes = 96L * 1024L * 1024L
Log.i(TAG, "Tighter dynamic budget applied for gallery: 96MB")
} catch (e: IllegalArgumentException) {
Log.e(TAG, "Could not apply dynamic budget", e)
}
}
companion object {
private const val TAG = "ImageEditor"
}
}
Hiệu chỉnh, thử nghiệm và phát hành ngân sách
Để triển khai đúng cách ngân sách bộ nhớ, bạn cần thực hiện 3 bước:
- Hiệu chỉnh ngân sách cho từng trạng thái quy trình.
- Kiểm thử kỹ lưỡng trước khi phát hành.
- Phát hành theo giai đoạn: xác thực tính năng này sau cấu hình từ xa, đưa tính năng này vào tệp kê khai và tiếp tục đo lường.
Hiệu chỉnh ngân sách
Ngân sách phù hợp là ngân sách cao hơn một chút so với tập hợp đang hoạt động của ứng dụng cho một trạng thái nhất định, chứ không phải ở mức cao nhất không bị ràng buộc. Để tìm điểm đó, hãy chạy một luồng người dùng thực tế, giảm dần ngân sách và theo dõi thời điểm ứng dụng của bạn bắt đầu trả phí cho ngân sách đó.
Tìm hiểu về tập hợp đang hoạt động so với bộ nhớ thường trú
Nếu không có ngân sách, mức sử dụng bộ nhớ thường trú (memory.current) của ứng dụng sẽ giữ hai loại bộ nhớ:
- Tập hợp đang hoạt động: Java, Kotlin, vùng nhớ khối xếp gốc và các trang được hỗ trợ tệp nóng (mã DEX, thư viện gốc và tài sản) mà luồng người dùng hiện tại liên tục chạm vào
- Cold slack: bộ nhớ đệm bitmap từ các màn hình trước đó, vùng đệm khởi động một lần, vùng nhớ khối xếp còn lại sau khi phân bổ và các trang tệp đã được đọc một lần và không bao giờ được chạm vào nữa
Ngân sách ở mức cao nhất không bị ràng buộc sẽ không bao giờ lấy lại được khoảng thời gian rảnh rỗi. Ngân sách thấp hơn tập hợp đang hoạt động sẽ khiến hạt nhân hoán đổi các trang vùng nhớ khối xếp và loại bỏ các trang mã mà ứng dụng của bạn ngay lập tức lỗi trở lại. Những lỗi trang lặp lại trong tập hợp đang hoạt động này làm tốn thời gian của CPU và pin, đồng thời cũng làm tốn khung hình khi chúng xuất hiện trên luồng giao diện người dùng.
Điều bạn đang tìm kiếm là điểm uốn: ngân sách thấp nhất mà tại đó, việc thu hồi chỉ loại bỏ phần dư thừa không hoạt động, vì vậy, lỗi trang lặp lại, thời gian của CPU và thời gian kết xuất khung hình vẫn giữ nguyên như khi không có ngân sách.
Chuẩn bị môi trường thử nghiệm
Thiết lập một chương trình kiểm thử có thể lặp lại và hoạt động giống như môi trường thực tế:
- Hiệu chỉnh cùng một bản phát hành không thể gỡ lỗi, được tối ưu hoá cho R8 mà bạn phát hành. Bản gỡ lỗi sử dụng nhiều bộ nhớ hơn, vì vậy, ngân sách được điều chỉnh trên bản gỡ lỗi sẽ quá cao cho bản phát hành.
- Kiểm thử trên một thiết bị hoặc trình mô phỏng chạy Android 17 QPR2 (cấp độ API 37.2) trở lên. Bản dựng
userdebughoặc hình ảnh trình mô phỏng không có Google Play sẽ thuận tiện khi lấy mẫu tệp cgroup từadb shell, vì việc đọc thư mục cgroup của ứng dụng từ shell có thể yêu cầuadb root. Ứng dụng có thể đọc mức sử dụng cgroup của quy trình riêng trong quy trình thông quaMemoryBudgetManagerngay cả trên các bản dựng chính thức. - Tạo tập lệnh cho luồng người dùng từ 30 đến 60 giây bằng Jetpack Macrobenchmark, UI Automator hoặc
adb shell input, mỗi lần cho một trạng thái mà bạn dự định lập ngân sách. Một ứng dụng rảnh không cho bạn biết gì về tập hợp đang hoạt động của ứng dụng đó.foreground: cuộn danh sách dày đặc và lưới nội dung nghe nhìn, di chuyển giữa các đích đến chính, mở trình đơn và hộp thoại, cũng như chạy ảnh độngperceptible: rời khỏi cửa sổ hiển thị trong khi công việc có thể nhận biết được vẫn tiếp tục (ví dụ: phát âm thanh hoặc tải xuống), để công việc đó chạy trong 10 đến 15 giây, sau đó quay lại ứng dụngbackground: kích hoạt một quá trình đồng bộ hoá, một công việcWorkManager(ví dụ: vớiadb shell cmd jobscheduler run -f <package-name> <job-id>), một dịch vụ đã bắt đầu hoặc một bộ nhận tín hiệu truyền tin trong khi ứng dụng không có giao diện người dùng hiển thị
Đo lường ngân sách background trong khi công việc ở chế độ nền đang chạy, thay vì khi quy trình ở trạng thái rảnh trong trạng thái đã lưu vào bộ nhớ đệm (IMPORTANCE_CACHED). Mặc dù ngân sách background vẫn có hiệu lực khi được lưu vào bộ nhớ đệm, nhưng quy trình đã lưu vào bộ nhớ đệm ở trạng thái rảnh sẽ không thực thi công việc ở chế độ nền và không phản ánh tập hợp hoạt động của các công việc hoặc trình nhận ở chế độ nền.
Đo lường mức cơ sở
Bắt đầu với những lần chạy không có ngân sách để biết mức bình thường là bao nhiêu.
Sử dụng một bản dựng không có nội dung khai báo <memory-budget> và bắt đầu mỗi lần chạy từ một quy trình mới (adb shell am force-stop <package-name>).
Mỗi quy trình ứng dụng đều có bộ điều khiển bộ nhớ cgroup v2 riêng. Tra cứu đường dẫn của tệp này từ dòng 0:: của /proc/<PID>/cgroup thay vì cố định giá trị trong mã của đường dẫn. Truyền từng
lệnh thiết bị đến adb shell dưới dạng một chuỗi được đặt trong dấu ngoặc kép để
vỏ thiết bị thấy dấu ngoặc kép:
PID=$(adb shell pidof -s <package-name>)CG=/sys/fs/cgroup$(adb shell "sed -n 's/^0:://p' /proc/$PID/cgroup")adb shell "cat $CG/memory.current $CG/memory.swap.current"adb shell "grep -E '^(anon|file|workingset_refault_.*) ' $CG/memory.stat"
Việc đọc các tệp này không tốn nhiều tài nguyên và không làm gián đoạn ứng dụng, vì vậy, bạn có thể lấy mẫu các tệp này mỗi giây trong một lần chạy:
memory.current: bộ nhớ thường trú được tính cho quy trình, tính bằng byte. Đây là số lượng mà<memory-budget>giới hạn.memory.swap.current: bộ nhớ được nén vào bộ nhớ hoán đổi zRAM, tính bằng byteanonvàfiletrongmemory.stat: bộ nhớ ẩn danh và bộ nhớ được tệp hỗ trợ, tính bằng byteworkingset_refault_anonvàworkingset_refault_filetrongmemory.stat: số lượng trang bị hoán đổi hoặc bị loại bỏ mà ứng dụng của bạn cần dùng lại. Các bộ đếm này là dấu hiệu chính cho thấy ngân sách quá hạn hẹp.
Nếu bạn gặp lỗi về quyền khi đọc tệp cgroup của ứng dụng từ adb
shell, hãy chạy adb root trên bản dựng userdebug hoặc hình ảnh trình mô phỏng không có Google Play, rồi thử lại. Trên các bản dựng chính thức user không có adb root, hãy truy vấn MemoryBudgetManager.processCurrentUsageBytes từ bên trong ứng dụng hoặc sử dụng adb shell dumpsys meminfo <package-name> để có chế độ xem thô hơn.
Trong App Summary, Java Heap, Native Heap và Stack hầu hết là bộ nhớ ẩn danh, còn Code là bộ nhớ dựa trên tệp. Bitmap phần mềm được tính vào Native Heap và ngân sách của bạn, trong khi bitmap phần cứng và Graphics thì không. Đừng chạy dumpsys meminfo trong một vòng lặp khi bạn đo lường thời gian kết xuất khung hình. Tính năng này buộc thu thập rác trong ứng dụng và duyệt qua tất cả các liên kết bộ nhớ, từ đó thay đổi những gì bạn đang cố gắng đo lường.
Quét ngân sách của ứng viên
Bạn có thể thử các ngân sách đề xuất mà không cần tạo lại ứng dụng. Hãy sử dụng am memory-limiter manual để đặt ngân sách cho một quy trình đang chạy và none để xoá ngân sách đó:
adb shell am memory-limiter manual <PID> 120MBadb shell am memory-limiter manual <PID> none
Thao tác ghi đè thủ công sẽ kéo dài trong suốt thời gian hoạt động của thực thể quy trình đó, trong suốt các thay đổi về trạng thái quy trình, vì vậy, hãy xoá hoặc khởi động lại quy trình trước khi tiếp tục.
Hàm này cũng đặt giới hạn cứng của quy trình (memory.max) thành cùng một giá trị, vì vậy, ngân sách đề xuất thấp hơn tập hợp đang hoạt động của ứng dụng có thể khiến quy trình bị buộc tắt thay vì chỉ làm chậm quy trình. Coi đó là ngân sách không thành công.
Bạn cũng có thể quét từ một bản dựng điểm chuẩn bằng cách đọc giá trị đề xuất từ đối số đo lường và đặt MemoryBudgetManager.processBudgetBytes. Ngân sách thời gian chạy chỉ có thể thắt chặt ngân sách tệp kê khai, vì vậy, hãy quét một bản dựng không có nội dung khai báo <memory-budget>. Chế độ này cũng duy trì hiệu lực trong suốt các thay đổi về trạng thái quy trình cho đến khi bạn gọi clearProcessBudget.
Bắt đầu ở mức memory.current cao nhất so với mức cơ sở và giảm dần từ 10 đến 15 MB mỗi lần. Đối với mỗi ngân sách đề xuất:
- Bắt đầu một quy trình mới, đưa quy trình đó vào trạng thái mục tiêu và áp dụng ngân sách.
- Chạy luồng người dùng một lần để khởi động. Việc áp dụng ngân sách sẽ loại bỏ các trang khởi động nguội một lần và bạn muốn đo lường trạng thái ổn định thay vì quá trình chuyển đổi đó.
Đặt lại số liệu thống kê về khung hình, đồng thời ghi lại bộ đếm lỗi trang bắt đầu và Thời gian của CPU của quy trình (
utimevàstime, tính bằng nhịp đồng hồ):adb shell dumpsys gfxinfo <package-name> resetadb shell "grep -E '^workingset_refault_(anon|file) ' $CG/memory.stat"adb shell "cut -d ' ' -f 14,15 /proc/$PID/stat"Chạy lượt đo lường cho luồng người dùng.
Ghi lại
memory.current,anon,file, bộ đếm lỗi lặp lại và thời gian của CPU một lần nữa, đồng thời thu thập số liệu thống kê về khung hình.dumpsys gfxinfocó thể in cùng một số liệu thống kê nhiều lần, vì vậy, hãy lấy kết quả khớp đầu tiên, bao gồm toàn bộ ứng dụng:adb shell "dumpsys gfxinfo <package-name>" | grep -m 1 'Janky frames:'adb shell "dumpsys gfxinfo <package-name>" | grep -m 1 '95th percentile'
Lặp lại mỗi ứng viên ít nhất ba lần và xen kẽ các ứng viên thay vì chạy tất cả các lần lặp lại của một ứng viên liên tiếp. So sánh từng kết quả với mức chênh lệch của các lần chạy cơ sở, chứ không phải với một lần chạy duy nhất.
Đọc kết quả
Khi ngân sách giảm, ứng dụng của bạn sẽ trải qua 3 chế độ:
- Trên đầu gối:
memory.currenttuân theo ngân sách bằng cách loại bỏ các trangfilenguội và vùng nhớ khối xếp rảnh.anonkhông đổi, lỗi lặp lại vẫn ở gần mức cơ sở, còn thời gian của CPU và thời gian kết xuất khung hình không thay đổi. Đây là nơi bạn muốn đến. - Dưới đầu gối: Các trang lạnh đã biến mất, vì vậy, hạt nhân bắt đầu hoán đổi các trang vùng nhớ khối xếp mà ứng dụng của bạn vẫn sử dụng. Số lỗi trang lặp lại tăng lên hàng trăm hoặc hàng nghìn trang mỗi lần chạy và thời gian của CPU cũng tăng lên. Thời gian kết xuất khung hình có thể hầu như không thay đổi trên một thiết bị thử nghiệm đang ở trạng thái rảnh, nhưng ứng dụng của bạn hiện đang tiêu tốn thời gian của CPU và pin để nén và giải nén tập hợp hoạt động của chính ứng dụng đó.
- Dưới mức giới hạn: Lỗi thu hồi và hoán đổi xảy ra trên luồng giao diện người dùng và
RenderThread, đồng thời hiện tượng giật, thời gian kết xuất khung hình và thời gian tiếp tục ấm đều tăng lên.
So với mức cơ sở không bị ràng buộc, ngân sách đề xuất sẽ được thông qua nếu đáp ứng tất cả các điều kiện sau đây (đây là điểm xuất phát hợp lý):
- Quá trình này vẫn tiếp tục chạy
- Lỗi trang mặc định vẫn gần với mức cơ sở
- Thời gian của CPU của quy trình tăng không quá 5%
- Tỷ lệ khung hình bị giật tăng không quá 1 điểm phần trăm
- Thời gian kết xuất khung hình P95 tăng không quá 3 mili giây
- Thời gian tiếp tục ấm (
TotalTimetừadb shell am start -W) tăng không quá 15% đối với ngân sáchperceptiblevàbackground
Điểm uốn là ngân sách đề xuất thấp nhất được thông qua. Ví dụ: sau đây là một lần quét trên nền trước cho một ứng dụng giả định có mức sử dụng tối đa không bị ràng buộc là 138 MB:
| Ngân sách đề xuất | memory.current |
anon |
file |
Lỗi lặp lại (trang) | Thời gian kết xuất khung hình P95 | Chế độ |
|---|---|---|---|---|---|---|
| Không có | 138 MB | 75 MB | 63 MB | 0 | 10,5 mili giây | Cơ sở |
| 125 MB | 121 MB | 74 MB | 47 MB | 10 | 10,5 mili giây | Trên đầu gối |
| 110 MB | 110 MB | 75 MB | 35 MB | 15 | 10,8 mili giây | Đầu gối |
| 95 MB | 95 MB | 74 MB | 21 MB | 176 | 11,2 mili giây | Dưới đầu gối |
| 85 MB | 85 MB | 68 MB | 17 MB | 2.050 | 12,8 mili giây | Dưới đầu gối |
| 70 MB | 70 MB | 54 MB | 16 MB | 8.771 | 16,5 mili giây | Dưới đầu gối |
Chọn ngân sách
Đặt android:maxMb cao hơn 10% đến 20% so với điểm uốn để sự khác biệt về dữ liệu người dùng, ngôn ngữ và mức phân bổ đột biến không đẩy ứng dụng của bạn xuống dưới điểm uốn. Trong ví dụ trước, điểm uốn là 110 MB, vì vậy 125 MB là một lựa chọn phù hợp.
Sau đó, hãy cài đặt một bản phát hành có các nội dung khai báo <memory-budget> mới, chạy lại luồng người dùng và kiểm tra để đảm bảo các tiêu chí đạt vẫn được duy trì. Để xác nhận ngân sách đang hoạt động trong thời gian chạy, hãy truy vấn MemoryBudgetManager.processBudgetBytes hoặc MemoryBudgetManager.packageBudgetBytes.
Xác thực ngân sách không chạy trên nền trước bằng một lần trả về ấm
Ngân sách perceptible hoặc background eo hẹp có thể không có vấn đề gì khi ứng dụng của bạn ở trạng thái đó, nhưng sau đó sẽ khiến bạn tốn kém khi người dùng quay lại. Kiểm tra chuyến đi khứ hồi:
- Chạy quy trình trên nền trước, chuyển ứng dụng sang trạng thái mục tiêu và áp dụng ngân sách đề xuất bằng
am memory-limiter manual. - Để tác vụ có thể nhận biết hoặc tác vụ trong nền chạy từ 10 đến 15 giây.
- Xoá chế độ ghi đè (
adb shell am memory-limiter manual <PID> none), sau đó ngay lập tức đưa ứng dụng trở lại bằngadb shell am start -Wvà ghi lạiTotalTime. Nếu bạn đặt ứng viên thông quaMemoryBudgetManager, hãy gọiclearProcessBudgettrước khi ứng dụng trả về. - Chạy một hoạt động tương tác ngắn trên nền trước và kiểm tra lỗi tham chiếu cũng như số liệu thống kê về khung hình theo tiêu chí đạt.
Chọn ngân sách thấp nhất đáp ứng cả hai điều kiện trong khi ứng dụng ở trạng thái đó và khi quay lại ấm, đồng thời thêm khoảng trống từ 10% đến 20%.
Hiệu chỉnh tỷ lệ màn hình
Nếu bạn sử dụng android:additionalBytesPerDisplayPixel, hãy tìm điểm gối trước trên hai màn hình có độ phân giải khác nhau, chẳng hạn như 1080 × 2400 (≈ 2,59 triệu pixel) và 1440 × 3120 (≈ 4,49 triệu pixel).
Chia mức chênh lệch giữa hai điểm gãy (tính bằng byte) cho mức chênh lệch về số lượng pixel để có được android:additionalBytesPerDisplayPixel. Trừ lượng mỗi pixel đó cho màn hình nhỏ hơn từ điểm uốn để có được cơ sở không phụ thuộc vào độ phân giải, rồi thêm khoảng không để có được android:maxMb.
Thử nghiệm ngân sách
Trước khi phát hành ngân sách mới hoặc ngân sách chặt chẽ hơn, hãy kiểm tra những điều sau:
- Bản phát hành: Kiểm thử bản dựng mà bạn phát hành, như mô tả trong phần Chuẩn bị môi trường thử nghiệm.
- Mọi trạng thái được phân bổ ngân sách: Chạy các luồng trên nền trước, có thể nhận biết và chạy trong nền, đồng thời xác thực trạng thái trả về ấm cho từng ngân sách không thuộc nền trước.
- Thiết bị có RAM thấp: Bao gồm ít nhất một thiết bị thuộc cấp RAM thấp nhất mà bạn hỗ trợ.
- Kích thước cửa sổ: Nếu bạn sử dụng
android:additionalBytesPerDisplayPixel, hãy kiểm thử cửa sổ chia đôi màn hình và cửa sổ có thể đổi kích thước cũng như toàn màn hình, vì ngân sách theo tỷ lệ được tính từ kích thước cửa sổ của ứng dụng. - Dữ liệu thực tế: Thử nghiệm với các tài khoản lớn, danh sách dài và nhiều mục nội dung nghe nhìn, cũng như với các ngôn ngữ mà bạn cung cấp, vì các tập hợp hoạt động sẽ tăng lên khi có thêm dữ liệu.
- Ứng dụng đa quy trình: Thực thi từng quy trình có mệnh đề
<memory-budget>riêng. - Cổng hồi quy: Chạy các kiểm thử khởi động và giật hình Macrobenchmark hiện có của bạn khi có và không có ngân sách, đồng thời không đạt kiểm thử nếu lần chạy có ngân sách hồi quy vượt quá tiêu chí đạt.
Phát hành ngân sách theo giai đoạn
Ngân sách thời gian chạy được đặt thông qua MemoryBudgetManager chỉ có thể thắt chặt các giới hạn trong mức trần tệp kê khai <memory-budget> đã khai báo. Nó không thể tăng ngân sách tệp kê khai trong thời gian chạy. Đừng cung cấp các giá trị <memory-budget> quá cao trong AndroidManifest.xml và hãy lên kế hoạch giảm bớt các giá trị này bằng cờ máy chủ. Thay vào đó, hãy phát hành ngân sách mới theo hai giai đoạn:
- Xác thực sau cấu hình từ xa: Cung cấp tệp APK của bạn với một giới hạn an toàn
<memory-budget>duy nhất và không có mệnh đềperceptiblehoặcbackground(nên dùng) hoặc không có<memory-budget>. Kiểm soát ngân sách đề xuất bằng thử nghiệm phía máy chủ hoặc cờ cấu hình từ xa, đồng thời áp dụng ngân sách của trạng thái mục tiêu trong suốt quá trình chuyển đổi vòng đời, chẳng hạn như thông quaProcessLifecycleOwner. Bắt lỗiIllegalArgumentException, được gửi khi ngân sách thời gian chạy của thử nghiệm vượt quá giới hạn tệp kê khai tĩnh hoặc theo tỷ lệ cửa sổ hoặc giới hạn bộ nhớ hệ thống trên thiết bị có RAM thấp. Trong khốicatch, hãy gọiclearProcessBudgethoặcclearPackageBudgetđể ngân sách thời gian chạy chặt chẽ hơn từ trạng thái trước đó không còn hoạt động. So sánh các nhóm thử nghiệm theo cấp RAM của thiết bị dựa trên các chỉ số mà ngân sách có thể tác động: thời gian kết xuất khung hình, thời gian khởi động và tiếp tục nhanh, thời gian của CPU và pin. - Đưa ngân sách đã được chứng minh vào tệp kê khai: Sau khi dữ liệu thực tế cho thấy ngân sách đề xuất đáp ứng tiêu chí đạt của bạn trên các cấp RAM của thiết bị, hãy chuyển ngân sách
foreground,perceptiblevàbackgroundở trạng thái ổn định vào các mệnh đề<memory-budget>. Phát hành phiên bản đó theo giai đoạn và theo dõi các chỉ số tương tự.
Trong quá trình xác thực thời gian chạy, cờ cấu hình từ xa là nút tắt của bạn.
Khi bạn tắt cờ, các quy trình mới bắt đầu sẽ bỏ qua việc đặt ngân sách thời gian chạy và việc gọi clearProcessBudget hoặc clearPackageBudget sẽ xoá mọi ngân sách thời gian chạy đang hoạt động trong một quy trình đang chạy. Ứng dụng của bạn sẽ quay lại mức trần an toàn trong tệp kê khai hoặc không có ngân sách ứng dụng nếu bạn không khai báo, mà không cần bản cập nhật ứng dụng.
Hãy giữ cờ này trong cấu hình ứng dụng và máy chủ của riêng bạn thay vì dựa vào thiết bị hoặc hệ điều hành để tắt ngân sách.
Hãy coi ngân sách chỉ được đặt trong thời gian chạy là một bước triển khai tạm thời. Ngân sách tệp kê khai được cung cấp bên trong tệp APK đã ký và áp dụng từ khi khởi động quy trình mà không cần mã ứng dụng. Bạn cũng có thể kiểm tra các thành phần này mà không cần chạy ứng dụng bằng cách gọi PackageManager.getMemoryBudgets. Hàm này chỉ đọc các nội dung khai báo <application> tĩnh. Sau này, nếu muốn nới lỏng ngân sách trong tệp kê khai, bạn cần phải cập nhật ứng dụng. Tuy nhiên, bạn vẫn có thể chạy các thử nghiệm thắt chặt ngân sách trong thời gian chạy dưới mức trần của tệp kê khai.