edde746
3f49bcabf8
Upstream shared_preferences_windows and _linux write the whole preference document with a bare `writeAsStringSync`. That opens with the default `FileMode.write`, which truncates the live file before writing it, so every single preference write has a window in which the only copy on disk is empty or half-written. A crash, power loss, forced reboot or antivirus interception inside that window leaves a document that fails to parse on every subsequent launch — and the store holds the credential-vault key, so the loss is not recoverable by rewriting it. This is the corruption class behind #1732; the recovery path already landed is a band-aid over it. Vendor both packages under packages/ — the convention saf_util and wakelock_plus already follow — and stage, flush, then rename over the target. The flush has to precede the rename or it could publish contents that were never committed, the same corruption by another route. Staging uses one fixed sibling name rather than a stamped one, because the file is a plaintext copy of the vault key, tracker refresh tokens and Seerr cookies; it is created in the target's own directory so rename stays on one volume and the mode matches what the canonical file would have had, and a stale one is swept once the canonical document has been read cleanly. Both deltas are marked in-source and in provenance.json with the refresh contract. Atomicity is proven, not asserted. A hard link to the store observes the old document after a write, which only holds when the directory entry was replaced — truncate-in-place would have rewritten the shared inode, and that test does fail against unpatched upstream. Upstream's own suites still pass unchanged in both packages and now run in CI, so the patch keeps the contract it inherited. Windows `MoveFileExW` replacement semantics cannot be proven on a POSIX runner or a memory file system, so they get their own test on the existing windows-latest job, including replacement while a reader holds the file open — antivirus and Search Indexer both do.
128 lines
3.1 KiB
Markdown
128 lines
3.1 KiB
Markdown
## 2.4.1 (Plezy vendored patch)
|
|
|
|
Vendored from pub.dev `shared_preferences_linux` 2.4.1. Upstream writes the whole
|
|
preference document with a bare `writeAsStringSync`, which truncates the live
|
|
file before writing it, so every preference write has a window in which the
|
|
only copy on disk is empty or half-written. A crash inside that window leaves a
|
|
store that fails to parse on every later launch — and it holds the
|
|
credential-vault key, so the loss is not recoverable by rewriting it. This is
|
|
the corruption behind Plezy issue #1732.
|
|
|
|
The local patch stages the document to a sibling `.tmp`, flushes it, then
|
|
renames it over the target, and sweeps a stale staging file once the canonical
|
|
document has been read cleanly. The published example app is not vendored.
|
|
|
|
When updating, reapply both PLEZY DELTA blocks in `lib/shared_preferences_linux.dart`
|
|
and see `provenance.json` for the full refresh contract.
|
|
|
|
## 2.4.1
|
|
|
|
* Fixes `getStringList` returning immutable list.
|
|
* Fixes `getStringList` cast error.
|
|
* Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.
|
|
|
|
## 2.4.0
|
|
|
|
* Adds `SharedPreferencesAsyncLinux` API.
|
|
* Updates minimum supported SDK version to Flutter 3.16/Dart 3.2.
|
|
|
|
## 2.3.2
|
|
|
|
* Updates `package:file` version constraints.
|
|
|
|
## 2.3.1
|
|
|
|
* Adds pub topics to package metadata.
|
|
* Updates minimum supported SDK version to Flutter 3.7/Dart 2.19.
|
|
|
|
## 2.3.0
|
|
|
|
* Adds `clearWithParameters` and `getAllWithParameters` methods.
|
|
* Updates minimum supported SDK version to Flutter 3.3/Dart 2.18.
|
|
|
|
## 2.2.0
|
|
|
|
* Adds `getAllWithPrefix` and `clearWithPrefix` methods.
|
|
|
|
## 2.1.5
|
|
|
|
* Clarifies explanation of endorsement in README.
|
|
* Aligns Dart and Flutter SDK constraints.
|
|
|
|
## 2.1.4
|
|
|
|
* Updates links for the merge of flutter/plugins into flutter/packages.
|
|
* Updates minimum Flutter version to 3.0.
|
|
|
|
## 2.1.3
|
|
|
|
* Updates code for stricter lint checks.
|
|
|
|
## 2.1.2
|
|
|
|
* Updates code for stricter lint checks.
|
|
* Updates code for `no_leading_underscores_for_local_identifiers` lint.
|
|
* Updates minimum Flutter version to 2.10.
|
|
|
|
## 2.1.1
|
|
|
|
* Removes unnecessary imports.
|
|
* Fixes library_private_types_in_public_api, sort_child_properties_last and use_key_in_widget_constructors
|
|
lint warnings.
|
|
|
|
## 2.1.0
|
|
|
|
* Deprecated `SharedPreferencesWindows.instance` in favor of `SharedPreferencesStorePlatform.instance`.
|
|
|
|
## 2.0.4
|
|
|
|
* Removes dependency on `meta`.
|
|
|
|
## 2.0.3
|
|
|
|
* Removed obsolete `pluginClass: none` from pubpsec.
|
|
* Fixes newly enabled analyzer options.
|
|
|
|
## 2.0.2
|
|
|
|
* Updated installation instructions in README.
|
|
|
|
## 2.0.1
|
|
|
|
* Add `implements` to the pubspec.
|
|
* Add `registerWith` to the Dart main class.
|
|
|
|
## 2.0.0
|
|
|
|
* Migrate to null-safety.
|
|
|
|
## 0.0.3+1
|
|
|
|
* Update Flutter SDK constraint.
|
|
|
|
## 0.0.3
|
|
|
|
* Update integration test examples to use `testWidgets` instead of `test`.
|
|
|
|
## 0.0.2+4
|
|
|
|
* Remove unused `test` dependency.
|
|
* Update Dart SDK constraint in example.
|
|
|
|
## 0.0.2+3
|
|
|
|
* Check in linux/ directory for example/
|
|
|
|
## 0.0.2+2
|
|
|
|
* Bump the `file` package dependency to resolve dep conflicts with `flutter_driver`.
|
|
|
|
## 0.0.2+1
|
|
* Replace path_provider dependency with path_provider_linux.
|
|
|
|
## 0.0.2
|
|
* Add iOS stub.
|
|
|
|
## 0.0.1
|
|
* Initial release to support shared_preferences on Linux.
|