DataStore

Lưu trữ dữ liệu một cách không đồng bộ, có tính nhất quán và dựa trên giao dịch, giúp khắc phục một số hạn chế của SharedPreferences
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 22 tháng 10 năm 2025 1.1.7 - 1.2.0-beta01 -

Khai báo phần phụ thuộc

Để thêm phần phụ thuộc trên DataStore, bạn phải thêm kho lưu trữ Google Maven vào dự án. Hãy đọc bài viết về Kho lưu trữ Maven của Google để biết thêm thông tin.

Có hai cách triển khai DataStore: Preferences và Proto. Hãy chọn một trong hai. Bạn cũng có thể thêm các phần phụ thuộc ngoài Android để triển khai.

Thêm các phần phụ thuộc cần thiết để triển khai trong tệp build.gradle cho ứng dụng hoặc mô-đun:

Preferences DataStore

Groovy

    // Preferences DataStore (SharedPreferences like APIs)
    dependencies {
        implementation "androidx.datastore:datastore-preferences:1.1.7"

        // optional - RxJava2 support
        implementation "androidx.datastore:datastore-preferences-rxjava2:1.1.7"

        // optional - RxJava3 support
        implementation "androidx.datastore:datastore-preferences-rxjava3:1.1.7"
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation "androidx.datastore:datastore-preferences-core:1.1.7"
    }

Kotlin

    // Preferences DataStore (SharedPreferences like APIs)
    dependencies {
        implementation("androidx.datastore:datastore-preferences:1.1.7")

        // optional - RxJava2 support
        implementation("androidx.datastore:datastore-preferences-rxjava2:1.1.7")

        // optional - RxJava3 support
        implementation("androidx.datastore:datastore-preferences-rxjava3:1.1.7")
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation("androidx.datastore:datastore-preferences-core:1.1.7")
    }

Proto DataStore

Groovy

    // Typed DataStore (Typed API surface, such as Proto)
    dependencies {
        implementation "androidx.datastore:datastore:1.1.7"

        // optional - RxJava2 support
        implementation "androidx.datastore:datastore-rxjava2:1.1.7"

        // optional - RxJava3 support
        implementation "androidx.datastore:datastore-rxjava3:1.1.7"
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation "androidx.datastore:datastore-core:1.1.7"
    }

Kotlin

    // Typed DataStore (Typed API surface, such as Proto)
    dependencies {
        implementation("androidx.datastore:datastore:1.1.7")

        // optional - RxJava2 support
        implementation("androidx.datastore:datastore-rxjava2:1.1.7")

        // optional - RxJava3 support
        implementation("androidx.datastore:datastore-rxjava3:1.1.7")
    }

    // Alternatively - use the following artifact without an Android dependency.
    dependencies {
        implementation("androidx.datastore:datastore-core:1.1.7")
    }

Phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.2

Phiên bản 1.2.0-beta01

Ngày 22 tháng 10 năm 2025

Phát hành androidx.datastore:datastore-*:1.2.0-beta01. Phiên bản 1.2.0-beta01 bao gồm các thay đổi sau.

Thay đổi về API

  • Đặt CorruptionHandler ở chế độ công khai. (I9ac35, b/452406457)
  • Sử dụng androidx.core.util.Function trong GuavaDataStore. (I71eae, b/448563999)
  • Thêm một phương thức nạp chồng cho GuavaDataStore.from nhận một Executor thay vì CoroutineContext. (I989fa, b/448563183)

Sửa lỗi

  • Khắc phục java.lang.UnsatisfiedLinkError khi sử dụng DataStore trong một ứng dụng được tối ưu hoá bằng R8, nhưng không sử dụng getDefaultProguardFile('android-proguard-optimize.txt'). (I27d0d, b/434696293)
  • Khắc phục vấn đề trong đó các thao tác GuavaDataStore có thể chạy không chính xác trên luồng gọi (ví dụ: luồng chính) thay vì trình điều phối IO đã chỉ định. (Ic91ea,b/441801112)

Phiên bản 1.2.0-alpha02

Ngày 7 tháng 5 năm 2025

Phát hành androidx.datastore:datastore-*:1.2.0-alpha02. Phiên bản 1.2.0-alpha02 bao gồm các thay đổi sau.

Thay đổi về API

  • Thêm tính năng hỗ trợ đa quy trình trong GuavaDataStore. (e0d608a).
  • Thêm một phương thức trợ giúp để tạo GuavaDataStore từ DataStore. (9af26f4)
  • Các dự án được phát hành bằng Kotlin 2.0 yêu cầu sử dụng KGP 2.0.0 trở lên. (Idb6b5)
  • Thay thế phương thức nạp chồng datastore hiện có bằng một phương thức uỷ quyền để khởi động DataStore sẽ được dùng trong quá trình khởi động trực tiếp. (If71b9)

Phiên bản 1.2.0-alpha01

Ngày 26 tháng 3 năm 2025

Phát hành androidx.datastore:datastore-*:1.2.0-alpha01. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Đã thêm mô-đun datastore-guava để cung cấp các API thân thiện với người dùng Java và Guava ListenableFuture thông qua GuavaDataStore. (Iadd5e0)
  • Hiện tại, chúng tôi đã hỗ trợ việc sử dụng DataStore trong chế độ DirectBoot. Để tạo một kho dữ liệu được dùng trong chế độ khởi động trực tiếp, bạn phải tạo kho dữ liệu đó trong bộ nhớ được bảo vệ của thiết bị. Bạn có thể làm được điều này bằng các API DataStore mới sau đây: createInDeviceProtectedStorage() trong DataStoreFactory và deviceProtectedDataStore() trong DataStoreDelegate. (Ib90e56)

Thay đổi về API

  • Đã thêm PreferencesFileSerializer triển khai giao diện androidx.datastore.core.Serializer để sử dụng với FileStorage. (I4c71f3)

Sửa lỗi

  • Giải quyết vấn đề FileNotFoundException trong OkioStorage khi khởi động bằng cách thêm một lần thử thứ hai để đọc dữ liệu trong trường hợp xảy ra tình trạng xung đột. (I43b3fb, b/337870543)
  • Xác định hàm khởi tạo mặc định cho ReplaceFileCorruptionHandler để sử dụng mã chung. (I795b05, b/358138957)

Phiên bản 1.1

Phiên bản 1.1.7

Ngày 20 tháng 5 năm 2025

Phát hành androidx.datastore:datastore-*:1.1.7. Phiên bản 1.1.7 chứa những thay đổi đã được xác nhận này.

Sửa lỗi

  • Khắc phục vấn đề thiếu quy tắc Proguard trong cấu phần phần mềm Android của datastore-preferences-core. (3f3f6e, b/413078297)

Phiên bản 1.1.6

Ngày 7 tháng 5 năm 2025

Phát hành androidx.datastore:datastore-*:1.1.6. Phiên bản 1.1.6 bao gồm các thay đổi sau.

Sửa lỗi

  • Đã giải quyết vấn đề siêu dữ liệu Gradle bị hỏng trong phiên bản 1.1.5. Vấn đề này là do một lỗi trong DSL của trình bổ trợ KMP AGP mới, ngăn không cho siêu dữ liệu của tất cả các nền tảng mục tiêu được tự động đưa vào. Lỗi này khiến một số phương thức DataStore Android không còn xuất hiện trong bản dựng của ứng dụng nữa. Bản sửa lỗi này liên quan đến việc sử dụng DSL android cũ trong build.gradle thay vì androidLibrary. (7801abf)

Phiên bản 1.1.5

Ngày 23 tháng 4 năm 2025

Phát hành androidx.datastore:datastore-*:1.1.5. Phiên bản 1.1.5 bao gồm các thay đổi sau.

Sửa lỗi

  • Để giảm thiểu các vấn đề về CorruptionException trong PreferencesDataStore, Bộ nhớ mặc định đã được thay đổi từ OkioStorage thành FileStorage. Thay đổi này được triển khai bằng cách giới thiệu một PreferencesFileSerializer. b/346197747

Phiên bản 1.1.4

Ngày 26 tháng 3 năm 2025

Phát hành androidx.datastore:datastore-*:1.1.4. Phiên bản 1.1.4 bao gồm các thay đổi sau.

Sửa lỗi

  • Thay thế bộ nhớ mặc định từ OkioStorage thành FileStorage để cải thiện độ tin cậy bằng cách giảm CorruptionException. (I71181, b/346197747)

Phiên bản 1.1.3

Ngày 26 tháng 2 năm 2025

Phát hành androidx.datastore:datastore-*:1.1.3. Phiên bản 1.1.3 bao gồm các thay đổi sau.

Sửa lỗi

  • Đã giải quyết vấn đề FileNotFoundException trong OkioStorage gặp phải khi khởi động ứng dụng. Nếu lần đọc tệp ban đầu không thành công, hệ thống sẽ thử lại lần thứ hai trong trường hợp xảy ra tình trạng xung đột do tệp được tạo bởi một quy trình khác trong lần đọc ban đầu. (I43b3f, b/337870543)

Phiên bản 1.1.2

Ngày 15 tháng 1 năm 2025

Phát hành androidx.datastore:datastore-*:1.1.2. Phiên bản 1.1.2 bao gồm các thay đổi sau.

Sửa lỗi

  • Cải thiện độ trễ đọc dữ liệu (DataStore.data.first()) lên gấp 8 lần. (22b8a40)
  • ReplaceFileCorruptionHandler có thể được tạo từ mã chung KMP. (7632e839)

Phiên bản 1.1.1

Ngày 1 tháng 5 năm 2024

Phát hành androidx.datastore:datastore-*:1.1.1. Phiên bản 1.1.1 bao gồm các thay đổi sau.

Sửa lỗi

  • Giảm thiểu cảnh báo sai trên Linux về lỗi "Sẽ xảy ra tình trạng tắc nghẽn tài nguyên" trong trường hợp có nhiều phiên bản DataStore cố gắng ghi từ các quy trình khác nhau bằng cách sao lưu khoá tệp.

Phiên bản 1.1.0

Ngày 17 tháng 4 năm 2024

Phát hành androidx.datastore:datastore-*:1.1.0. Phiên bản 1.1.0 bao gồm các thay đổi sau.

Các thay đổi lớn kể từ phiên bản 1.0.0

Vui lòng xem ghi chú phát hành của các phiên bản alpha và beta 1.1.0 để biết thêm thông tin. Một số điểm cập nhật chính trong phiên bản 1.1.0 là:

  • DataStore hiện hỗ trợ nhiều quy trình truy cập vào cùng một tệp, đồng thời hỗ trợ khả năng quan sát trên các quy trình.
  • Giao diện Bộ nhớ mới cho phép bạn tuỳ chỉnh cách lưu trữ hoặc chuyển đổi mô hình dữ liệu của mình.
  • Giờ đây, bạn có thể sử dụng DataStore trong các dự án Kotlin Multiplatform.

Phiên bản 1.1.0-rc01

Ngày 3 tháng 4 năm 2024

Phát hành androidx.datastore:datastore-*:1.1.0-rc01. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.

Sửa lỗi

  • Khắc phục tình trạng giảm hiệu suất khi các lệnh gọi updateData không tối ưu hoá các thao tác ghi trên đĩa nếu dữ liệu mới giống với dữ liệu cũ (d64cfb5)
  • Khắc phục một điều kiện tranh đấu khiến MultiProcess DataStore có thể bỏ lỡ các lượt vô hiệu hoá trong quá trình khởi chạy. ((b/326141553),(094c2dd))

Phiên bản 1.1.0-beta02

Ngày 6 tháng 3 năm 2024

Phát hành androidx.datastore:datastore-*:1.1.0-beta02. Phiên bản 1.1.0-beta02 bao gồm các thay đổi sau.

Sửa lỗi

  • Tính năng cải thiện hiệu suất trên DataStore chỉ thu thập thông báo cập nhật khi được quan sát. (b/267792241)
    • Xin lưu ý rằng thay đổi này có thể kích hoạt UncompletedCoroutinesError trong các kiểm thử nếu bạn đang sử dụng thư viện kiểm thử Coroutines. Hãy nhớ truyền TestScope.backgroundScope khi khởi tạo DataStore trong các kiểm thử để tránh gặp phải vấn đề này.
  • ​Khắc phục vấn đề về các lệnh gọi updateData lồng nhau trên cùng một phiên bản sẽ bị tắc nghẽn. (b/241760537)
  • Không để DataStore gửi IOExceptions nữa nếu không xoá được SharedPreferences trong quá trình di chuyển. (b/195553816)
  • Khắc phục vấn đề khiến việc đổi tên tệp không thành công trong quá trình updateData ở các môi trường JVM không phải Android. (b/203087070)
  • Khắc phục vấn đề CorruptionException không được xử lý sau khi khởi chạy DataStore. (b/289582516)

Phiên bản 1.1.0-beta01

Ngày 10 tháng 1 năm 2024

androidx.datastore:datastore-*:1.1.0-beta01 được phát hành mà không có thay đổi nào kể từ 1.1.0-alpha07. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.

Phiên bản 1.1.0-alpha07

Ngày 29 tháng 11 năm 2023

Phát hành androidx.datastore:datastore-*:1.1.0-alpha07. Phiên bản 1.1.0-alpha07 bao gồm các thay đổi sau.

Thay đổi về API

  • Các phương thức MultiProcessDataStoreFactory không còn mang tính thử nghiệm nữa.Chú giải @ExperimentalMultiProcessDataStore đã bị xoá hoàn toàn. (Ieee54, I8e607)

Sửa lỗi

  • Triển khai việc xoá chú thích @ExperimentalMultiProcessDataStore cho phiên bản 1.1.0-alpha07. (I8e607)

Phiên bản 1.1.0-alpha06

Ngày 1 tháng 11 năm 2023

Phát hành androidx.datastore:datastore-*:1.1.0-alpha06. Phiên bản 1.1.0-alpha06 bao gồm các thay đổi sau.

Thay đổi về API

  • Phương thức nhà máy createSingleProcessCoordinator hiện nhận một đường dẫn tệp (String, java.io.File và okio.Path) để nhất quán với createMultiProcessCoordinator. (I211c8, b/305755935)

Phiên bản 1.1.0-alpha05

Ngày 6 tháng 9 năm 2023

Phát hành androidx.datastore:datastore-*:1.1.0-alpha05. Phiên bản 1.1.0-alpha05 bao gồm các thay đổi sau.

Thay đổi về API

  • Datastore FileStorage hiện đã được cung cấp công khai, vì vậy, các ứng dụng có thể cung cấp các tham số tuỳ chỉnh. (Icb985)
  • Thay đổi hàm khởi tạo OkioStorage để chấp nhận InterProcessCoordinator để có thể dùng trên Android với MultiProcessCoordinator. (Iecea3)

Sửa lỗi

  • Khắc phục lỗi MultiProcessCoordinator không thể giám sát nhiều tệp trong cùng một thư mục.
  • Khắc phục lỗi không phát hiện được tệp trùng lặp nếu đường dẫn tệp không được chuẩn hoá.
  • Khắc phục các giá trị không chính xác được trả về từ RxDataStore#isDisposed.
  • Khắc phục tình trạng thiếu cấu hình Proguard cho cấu phần phần mềm datstore-preferences-core.

Phiên bản 1.1.0-alpha04

Ngày 5 tháng 4 năm 2023

Phát hành androidx.datastore:datastore-*:1.1.0-alpha04. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.

Sửa lỗi

  • Cải thiện việc triển khai nội bộ để tránh điều kiện tranh đấu trong đó luồng dữ liệu của DataStore có thể phát ra một giá trị cũ hơn sau khi cập nhật.

Phiên bản 1.1.0-alpha03

Ngày 24 tháng 3 năm 2023

Phát hành androidx.datastore:datastore-*:1.1.0-alpha03.

Sửa lỗi

  • Xoá các ràng buộc về phần phụ thuộc khỏi cấu phần phần mềm Maven để giải quyết vấn đề về bản dựng trong Kotlin Native Targets (b/274786186, KT-57531).

Phiên bản 1.1.0-alpha02

Ngày 22 tháng 3 năm 2023

Phát hành androidx.datastore:datastore-*:1.1.0-alpha02. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.

Lưu ý

Xin lưu ý rằng phiên bản này bao gồm một hoạt động tái cấu trúc nội bộ quan trọng, hợp nhất các quy trình triển khai cho quy trình triển khai DataStore một quy trình và nhiều quy trình. Vui lòng chú ý đến những thay đổi có thể xảy ra ngoài ý muốn về hành vi (ví dụ: thời gian thông báo cập nhật). Bạn có thể sử dụng thành phần trình theo dõi lỗi để báo cáo những thay đổi như vậy.

Tính năng mới

  • Giờ đây, bạn có thể sử dụng DataStore trong các dự án KMM. Xin lưu ý rằng các mục tiêu không phải Android của DataStore vẫn đang trong giai đoạn thử nghiệm, nhưng chúng tôi quyết định hợp nhất các phiên bản để giúp nhà phát triển dễ dàng dùng thử.
  • Các tính năng đa quy trình được di chuyển từ androidx.datastore.multiprocess sang androidx.datastore.core.
  • Thêm một phương thức ban đầu mới trong androidx.datastore.core.MultiProcessDataStoreFactory để tạo các thực thể DataStore bằng các đối tượng Storage cho các thao tác trên tệp.
  • Thêm một giao diện InterProcessCoordinator mới giúp nhiều thực thể DataStore giao tiếp trên các quy trình. Xin lưu ý rằng việc triển khai Nhiều quy trình của InterProcessCoordinator chỉ có trên Android.

Thay đổi về API

  • Thêm InterProcessCoordinator vào StorageConnection trong giao diện datastore-core (I555bb)
  • Thay đổi các API trong MultiProcessDataStoreFactory của datastore-core để sử dụng Bộ nhớ. (Iac02f)
  • Di chuyển các API công khai trong datastore-multiprocess vào datastore-core (I76d7c)
  • Hiển thị PreferencesSerializer từ datastore-preferences-core (I4b788)
  • Thêm chú thích @JvmDefaultWithCompatibility (I8f206)

Phiên bản 1.1.0-alpha01

Ngày 9 tháng 11 năm 2022

Phát hành androidx.datastore:datastore-*:1.1.0-alpha01. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Hỗ trợ các trường hợp sử dụng gồm nhiều quy trình, trong đó đảm bảo tính nhất quán của dữ liệu giữa các thực thể DataStore trong các quy trình. Hãy thêm MultiProcessDataStoreFactory#create để tạo các thực thể DataStore như vậy.
  • Giao diện Bộ nhớ mới cho phép chuyển đổi cơ chế lưu trữ cơ bản của Datastore. Chúng tôi cung cấp các phương thức triển khai cho java.io và okio. Nhà máy DataStore có các phương thức mới chấp nhận đối tượng Bộ nhớ này.

Các thay đổi về API

  • Thay đổi các API trong MultiProcessDataStoreFactory của datastore-core để sử dụng Bộ nhớ. (Iac02f)
  • Di chuyển các API công khai trong datastore-multiprocess vào datastore-core (I76d7c)
  • Hiển thị PreferencesSerializer từ datastore-preferences-core (I4b788)

Phiên bản 1.0.0

Phiên bản 1.0.0

Ngày 4 tháng 8 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0. Phiên bản 1.0.0 bao gồm các thay đổi sau.

Các tính năng chính của phiên bản 1.0.0

Jetpack DataStore là một giải pháp lưu trữ dữ liệu cho phép lưu trữ các cặp khoá-giá trị hoặc đối tượng đã nhập có vùng đệm giao thức. DataStore sử dụng coroutine Kotlin và Flow để lưu trữ dữ liệu một cách không đồng bộ, nhất quán và dựa trên giao dịch.

Phiên bản 1.0.0-rc02

Ngày 21 tháng 7 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-rc02. Phiên bản 1.0.0-rc02 bao gồm các thay đổi sau.

Bản sửa lỗi

  • Làm rõ rằng SharedPreferencesMigration không chạy nếu không có khoá. (Icfa32, b/192824325)
  • Sửa lỗi SharedPreferencesMigration được tạo bằng MIGRATE_ALL_KEYS sẽ xảy ra ngoại lệ nếu khoá yêu cầu chưa tồn tại. (Ie318a, b/192824325)

Phiên bản 1.0.0-rc01

Ngày 30 tháng 6 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-rc01. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.

Bản sửa lỗi

  • Khắc phục lỗi tệp .gtm vô tình được thêm vào tệp jar cuối cùng (I65d96, b/188985637)

Phiên bản 1.0.0-beta02

Ngày 16 tháng 6 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-beta02. Phiên bản 1.0.0-beta02 bao gồm các thay đổi sau.

Bản sửa lỗi

Phiên bản 1.0.0-beta01

Ngày 21 tháng 4 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Thay đổi API

  • Bỏ JvmOverloads trong các phương thức của kotlin (I2adc7)

Bản sửa lỗi

  • Khắc phục lỗi khi uỷ quyền Datastore có thể dẫn đến rò rỉ ngữ cảnh (Ie96fc, b/184415662)

Phiên bản 1.0.0-alpha08

Ngày 10 tháng 3 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-alpha08. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Thay đổi API

  • Giờ đây, bạn có thể thêm quá trình di chuyển theo ngữ cảnh vào trường hợp uỷ quyền thuộc tính dataStore và preferencesDataStore. (I4ef69, b/173726702)
  • Thêm các chức năng trợ giúp để lấy tên tệp nếu bạn không còn sử dụng Delegate của DataStore hoặc context.createDataStore (I60f9a)
  • Tạm ngưng trình chuyển đổi tuần tự (Serializer) writeTo và readFrom. Nếu đã triển khai một trình chuyển đổi tuần tự, bạn cần phải cập nhật hàm thành các hàm tạm ngưng (suspend). (I1e58e)
  • Thêm thuộc tính delegate cho người dùng RxDataStore. (Ied768, b/173726702)

Bản sửa lỗi

Phiên bản 1.0.0-alpha07

Ngày 24 tháng 2 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-alpha07. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.

Thay đổi API

  • Hàm mở rộng Context.createDataStore đã bị xoá và được thay thế bằng việc uỷ quyền thuộc tính GlobalDataStore. Gọi GlobalDataStore một lần ở cấp cao nhất trong tệp kotlin. Ví dụ:

    val Context.myDataStore by dataStore(...)

    Đặt phần này ở cấp cao nhất của tệp kotlin để chỉ có một thực thể duy nhất của tệp. (I57215, b/173726702)

  • Các hàm RxDataStore hiện đã có trên một lớp RxDataStore thay vì các hàm mở rộng trên DataStore. (Idccdb, b/177691248)

  • Nếu muốn dịch chuyển EncryptedSharedPreferences (hoặc khởi động trực tiếp SharedPreferences) sang DataStore thì giờ bạn có thể làm việc đó bằng hàm khởi tạo (constructor) SharedPreferencesPreferences mới. Hàm khởi tạo cho phép bạn chèn SharedPreferences. (I8e04e, b/177278510)

Bản sửa lỗi

  • DataStore hiện sẽ khai báo trường hợp ngoại lệ nếu có nhiều DataStore đang hoạt động trong cùng một tệp. Nếu lúc trước bạn không quản lý DataStore dưới dạng Singleton hoặc không đảm bảo rằng không có hai thực thể DataStore nào đang hoạt động đồng thời trong cùng một tệp, thì giờ đây, bạn có thể nhận biết các trường hợp ngoại lệ khi đọc hoặc ghi vào DataStore. Bạn có thể khắc phục các lỗi này bằng cách quản lý DataStore dưới dạng Singleton. (Ib43f4, b/177691248)
  • Khắc phục hành vi hủy khi huỷ phạm vi phương thức gọi. (I2c7b3)

Phiên bản 1.0.0-alpha06

Ngày 13 tháng 1 năm 2021

Phát hành androidx.datastore:datastore-*:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm trình bao bọc RxJava cho DataStore. Cấu phần phần mềm datastore-rxjava2/3 chứa trình bao bọc cho API DataStore chính (RxDataStore, RxDataStoreBuilder, và RxDataMigration). Các cấu phần phần mềm datastore-preferences-rxjava2/3 chứa một trình dựngđể tạo một DataStore Preferences.

Thay đổi API

  • Ẩn giao diện CorruptionHandler. Không có lý do để công khai nội dung này vì nhà máy (factory) DataStore chỉ chấp nhận một tham số ChangeFileCorruptionHandler. (I0b3b3, b/176032264)
  • Phương thức preferencesKey<T>(name: String): Key<T> đã bị xoá và thay thế bằng các phương thức cụ thể cho từng loại API được hỗ trợ, ví dụ: preferencesKey<Int>("int") hiện là intPreferencesKey("int") (Ibcfac, b/170311106)

Bản sửa lỗi

  • Chỉnh sửa tài liệu trên nhà máy DataStore mà trước đó không đề cập đến việc tệp DataStore được tạo trong thư mục con “datastore/”. (Ica222)

Phiên bản 1.0.0-alpha05

Ngày 2 tháng 12 năm 2020

Phát hành androidx.datastore:datastore-*:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Bản sửa lỗi

  • Thêm các tài liệu và trường hợp ngoại lệ tốt hơn về cách ghi đồng thời từ các DataStore. (Ia98a2, b/173522155, b/173726702)
  • Hiện tại, chúng tôi cho phép (nhưng không yêu cầu) đóng OutputStream được truyền vào Serializer.writeTo(). (I5c9bf, b/173037611)

Phiên bản 1.0.0-alpha04

Ngày 17 tháng 11 năm 2020

Phát hành androidx.datastore:datastore-*:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Bản sửa lỗi

  • Khắc phục vấn đề khi đóng gói gây ra sự cố sau đây trong DataStore Preference 1.0.0-alpha03: java.lang.NoClassDefFoundError: Failed resolution of: Landroidx/datastore/preferences

Phiên bản 1.0.0-alpha03

Ngày 11 tháng 11 năm 2020

Phát hành androidx.datastore:datastore-*:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • DataStore Preference hiện hỗ trợ truyền hai giá trị (hữu ích nếu bạn cần độ chính xác cao hơn kiểu dữ liệu float) (I5be8f, b/169471808)

Thay đổi API

  • Đã tạo ra một phần phụ thuộc Kotlin thuần tuý cho DataStore để biên dịch nhanh hơn. androidx.datastore:datastore-core chỉ chứa các API kotlin chính và androidx.datastore:datastore chứa các API phụ thuộc vào Android (bao gồm SharedPreferencesMigration và hạm khởi tạo Context.createDataStore.)(I42d75, b/168512698)
  • Chia nhỏ các mục tiêu cho DataStore preference để biên dịch kotlin nhanh hơn (Ia3c19)

  • Serializer cần một thuộc tính mới cho giá trị mặc định mà sẽ được sử dụng nếu không có dữ liệu trên đĩa. Nhờ đó, bạn có thể dễ dàng hơn trong việc triển khai các trình chuyển đổi tuần tự tuỳ chỉnh để người dùng không phải đánh dấu các luồng đầu vào rỗng (luồng đầu vào rỗng không được phân tích cú pháp bằng json).

    • Ngoài ra, hiện có một bước kiểm tra để xác nhận luồng đầu ra được gửi đến writeTo() không bị đóng và nếu bị đóng thì sẽ xảy ra ngoại lệ (I16e29)

  • Đưa hàm khởi tạo cho SharedPreferencesView thành hàm nội bộ. Ban đầu, hàm khởi tạo được công khai để cho phép thử nghiệm. Thay vào đó, các lần kiểm thử phải tạo SharedPreferencesPreferences và thử nghiệm dựa vào đó. (I93891)

Bản sửa lỗi

  • Tham số produceFile trên DataStoreFactory và PreferenceDataStoreFactory hiện là tham số cuối cùng trong danh sách, nhờ đó bạn có thể sử dụng cú pháp có lambda ở cuối. (Ibe7f1, b/169425442)
  • Tuân thủ các yêu cầu mới về API tường minh trong kotlin (I5ae1e)

Các lỗi đã biết

  • DataStore Preference gặp sự cố với java.lang.NoClassDefFoundError. (b/173036843)

Phiên bản 1.0.0-alpha02

Ngày 14 tháng 10 năm 2020

Phát hành androidx.datastore:datastore-core:1.0.0-alpha02 và androidx.datastore:datastore-preferences:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Bản sửa lỗi

  • Thêm biện pháp bảo vệ phòng trường hợp đột biến (mutation) trong datastore-core. Tình trạng đột biến làm gián đoạn việc sử dụng DataStore đối với những người sử dụng DataStore không thuộc loại proto/preference(I6aa84)
  • Thêm phương thức toString vào Preferences.kt để dễ dàng gỡ lỗi trạng thái hiện tại (I96006)
  • Thêm một ngoại lệ để bảo vệ trong trường hợp sử dụng sai DataStore.Preferences (I1134d)
  • Khắc phục lỗi khiến ứng dụng ngừng hoạt động và thoát khi khởi động (I69237, b/168580258)

Phiên bản 1.0.0-alpha01

Ngày 2 tháng 9 năm 2020

Phát hành androidx.datastore:datastore-core:1.0.0-alpha01 và androidx.datastore:datastore-preferences:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Jetpack DataStore là một giải pháp lưu trữ dữ liệu mới và cải tiến nhằm thay thế SharedPreferences. DataStore được xây dựng dựa trên Kotlin coroutine và Kotlin flow, và có hai cách triển khai khác nhau:

  • DataStore Proto cho phép bạn lưu trữ object đã nhập (được hỗ trợ bởi bộ đệm giao thức)
  • Preference DataStore lưu trữ các cặp khoá-giá trị

Dữ liệu được lưu trữ không đồng bộ, nhất quán và có thể chia sẻ, khắc phục hầu hết các hạn chế của SharedPreferences.