Skip to content

Commit 40e6c7b

Browse files
[shared_preferences] Updates min SDK to 3.29 (#9829)
For the `shared_preferences` packages: - Updates the min SDK version to 3.29 - Runs the autoformatter with the new format - Update code excerpts This does not update versions because pushing format changes (even in READMEs) isn't worth doing a release that drops an SDK version (which we don't normally version) Prep for #9816
1 parent f9bd733 commit 40e6c7b

File tree

95 files changed

+4202
-4044
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

95 files changed

+4202
-4044
lines changed

packages/shared_preferences/shared_preferences/CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## NEXT
22

3-
* Updates minimum supported SDK version to Flutter 3.27/Dart 3.6.
3+
* Updates minimum supported SDK version to Flutter 3.29/Dart 3.7.
44
* Updates README to indicate that Andoid SDK <21 is no longer supported.
55

66
## 2.5.3

packages/shared_preferences/shared_preferences/README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -63,9 +63,11 @@ import 'package:shared_preferences_android/shared_preferences_android.dart';
6363
```dart
6464
const SharedPreferencesAsyncAndroidOptions options =
6565
SharedPreferencesAsyncAndroidOptions(
66-
backend: SharedPreferencesAndroidBackendLibrary.SharedPreferences,
67-
originalSharedPreferencesOptions: AndroidSharedPreferencesStoreOptions(
68-
fileName: 'the_name_of_a_file'));
66+
backend: SharedPreferencesAndroidBackendLibrary.SharedPreferences,
67+
originalSharedPreferencesOptions: AndroidSharedPreferencesStoreOptions(
68+
fileName: 'the_name_of_a_file',
69+
),
70+
);
6971
```
7072

7173
The [SharedPreferences] API uses the native [Android SharedPreferences](https://developer.android.com/reference/android/content/SharedPreferences) tool to store data.
@@ -136,8 +138,8 @@ await asyncPrefs.clear(allowList: <String>{'action', 'repeat'});
136138
### SharedPreferencesWithCache
137139
<?code-excerpt "readme_excerpts.dart (WithCache)"?>
138140
```dart
139-
final SharedPreferencesWithCache prefsWithCache =
140-
await SharedPreferencesWithCache.create(
141+
final SharedPreferencesWithCache
142+
prefsWithCache = await SharedPreferencesWithCache.create(
141143
cacheOptions: const SharedPreferencesWithCacheOptions(
142144
// When an allowlist is included, any keys that aren't included cannot be used.
143145
allowList: <String>{'repeat', 'action'},

packages/shared_preferences/shared_preferences/example/integration_test/shared_preferences_migration_util_test.dart

Lines changed: 51 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -41,32 +41,29 @@ void main() {
4141
});
4242

4343
group('SharedPreferences with setPrefix and allowList', () {
44-
runAllGroups(
45-
() {
46-
final Set<String> allowList = <String>{
47-
'prefix.$boolKey',
48-
'prefix.$intKey',
49-
'prefix.$doubleKey',
50-
'prefix.$listKey'
51-
};
52-
SharedPreferences.setPrefix('prefix.', allowList: allowList);
53-
},
54-
stringValue: null,
55-
);
44+
runAllGroups(() {
45+
final Set<String> allowList = <String>{
46+
'prefix.$boolKey',
47+
'prefix.$intKey',
48+
'prefix.$doubleKey',
49+
'prefix.$listKey',
50+
};
51+
SharedPreferences.setPrefix('prefix.', allowList: allowList);
52+
}, stringValue: null);
5653
});
5754

5855
group('SharedPreferences with prefix set to empty string', () {
59-
runAllGroups(
60-
() {
61-
SharedPreferences.setPrefix('');
62-
},
63-
keysCollide: true,
64-
);
56+
runAllGroups(() {
57+
SharedPreferences.setPrefix('');
58+
}, keysCollide: true);
6559
});
6660
}
6761

68-
void runAllGroups(void Function() legacySharedPrefsConfig,
69-
{String? stringValue = testString, bool keysCollide = false}) {
62+
void runAllGroups(
63+
void Function() legacySharedPrefsConfig, {
64+
String? stringValue = testString,
65+
bool keysCollide = false,
66+
}) {
7067
group('default sharedPreferencesAsyncOptions', () {
7168
const SharedPreferencesOptions sharedPreferencesAsyncOptions =
7269
SharedPreferencesOptions();
@@ -84,21 +81,22 @@ void runAllGroups(void Function() legacySharedPrefsConfig,
8481
if (Platform.isAndroid) {
8582
sharedPreferencesAsyncOptions =
8683
const SharedPreferencesAsyncAndroidOptions(
87-
backend: SharedPreferencesAndroidBackendLibrary.SharedPreferences,
88-
originalSharedPreferencesOptions: AndroidSharedPreferencesStoreOptions(
89-
fileName: 'fileName',
90-
),
91-
);
84+
backend: SharedPreferencesAndroidBackendLibrary.SharedPreferences,
85+
originalSharedPreferencesOptions:
86+
AndroidSharedPreferencesStoreOptions(fileName: 'fileName'),
87+
);
9288
} else if (Platform.isIOS || Platform.isMacOS) {
93-
sharedPreferencesAsyncOptions =
94-
SharedPreferencesAsyncFoundationOptions(suiteName: 'group.fileName');
89+
sharedPreferencesAsyncOptions = SharedPreferencesAsyncFoundationOptions(
90+
suiteName: 'group.fileName',
91+
);
9592
} else if (Platform.isLinux) {
9693
sharedPreferencesAsyncOptions = const SharedPreferencesLinuxOptions(
9794
fileName: 'fileName',
9895
);
9996
} else if (Platform.isWindows) {
100-
sharedPreferencesAsyncOptions =
101-
const SharedPreferencesWindowsOptions(fileName: 'fileName');
97+
sharedPreferencesAsyncOptions = const SharedPreferencesWindowsOptions(
98+
fileName: 'fileName',
99+
);
102100
} else {
103101
sharedPreferencesAsyncOptions = const SharedPreferencesOptions();
104102
}
@@ -114,10 +112,10 @@ void runAllGroups(void Function() legacySharedPrefsConfig,
114112
group('Android default sharedPreferences', () {
115113
const SharedPreferencesOptions sharedPreferencesAsyncOptions =
116114
SharedPreferencesAsyncAndroidOptions(
117-
backend: SharedPreferencesAndroidBackendLibrary.SharedPreferences,
118-
originalSharedPreferencesOptions:
119-
AndroidSharedPreferencesStoreOptions(),
120-
);
115+
backend: SharedPreferencesAndroidBackendLibrary.SharedPreferences,
116+
originalSharedPreferencesOptions:
117+
AndroidSharedPreferencesStoreOptions(),
118+
);
121119

122120
runTests(
123121
sharedPreferencesAsyncOptions,
@@ -128,9 +126,12 @@ void runAllGroups(void Function() legacySharedPrefsConfig,
128126
}
129127
}
130128

131-
void runTests(SharedPreferencesOptions sharedPreferencesAsyncOptions,
132-
void Function() legacySharedPrefsConfig,
133-
{String? stringValue = testString, bool keysAndNamesCollide = false}) {
129+
void runTests(
130+
SharedPreferencesOptions sharedPreferencesAsyncOptions,
131+
void Function() legacySharedPrefsConfig, {
132+
String? stringValue = testString,
133+
bool keysAndNamesCollide = false,
134+
}) {
134135
setUp(() async {
135136
// Configure and populate the source legacy shared preferences.
136137
SharedPreferences.resetStatic();
@@ -146,8 +147,9 @@ void runTests(SharedPreferencesOptions sharedPreferencesAsyncOptions,
146147
});
147148

148149
tearDown(() async {
149-
await SharedPreferencesAsync(options: sharedPreferencesAsyncOptions)
150-
.clear();
150+
await SharedPreferencesAsync(
151+
options: sharedPreferencesAsyncOptions,
152+
).clear();
151153
});
152154

153155
testWidgets('data is successfully transferred to new system', (_) async {
@@ -158,8 +160,9 @@ void runTests(SharedPreferencesOptions sharedPreferencesAsyncOptions,
158160
migrationCompletedKey: migrationCompletedKey,
159161
);
160162

161-
final SharedPreferencesAsync asyncPreferences =
162-
SharedPreferencesAsync(options: sharedPreferencesAsyncOptions);
163+
final SharedPreferencesAsync asyncPreferences = SharedPreferencesAsync(
164+
options: sharedPreferencesAsyncOptions,
165+
);
163166

164167
expect(await asyncPreferences.getBool(boolKey), testBool);
165168
expect(await asyncPreferences.getInt(intKey), testInt);
@@ -176,8 +179,9 @@ void runTests(SharedPreferencesOptions sharedPreferencesAsyncOptions,
176179
migrationCompletedKey: migrationCompletedKey,
177180
);
178181

179-
final SharedPreferencesAsync asyncPreferences =
180-
SharedPreferencesAsync(options: sharedPreferencesAsyncOptions);
182+
final SharedPreferencesAsync asyncPreferences = SharedPreferencesAsync(
183+
options: sharedPreferencesAsyncOptions,
184+
);
181185

182186
expect(await asyncPreferences.getBool(migrationCompletedKey), true);
183187
});
@@ -193,8 +197,9 @@ void runTests(SharedPreferencesOptions sharedPreferencesAsyncOptions,
193197
migrationCompletedKey: migrationCompletedKey,
194198
);
195199

196-
final SharedPreferencesAsync asyncPreferences =
197-
SharedPreferencesAsync(options: sharedPreferencesAsyncOptions);
200+
final SharedPreferencesAsync asyncPreferences = SharedPreferencesAsync(
201+
options: sharedPreferencesAsyncOptions,
202+
);
198203
await preferences.setInt(intKey, -0);
199204
await migrateLegacySharedPreferencesToSharedPreferencesAsyncIfNecessary(
200205
legacySharedPreferencesInstance: preferences,
@@ -204,7 +209,8 @@ void runTests(SharedPreferencesOptions sharedPreferencesAsyncOptions,
204209
expect(await asyncPreferences.getInt(intKey), testInt);
205210
},
206211
// Skips platforms that would be adding the preferences to the same file.
207-
skip: keysAndNamesCollide &&
212+
skip:
213+
keysAndNamesCollide &&
208214
(Platform.isWindows ||
209215
Platform.isLinux ||
210216
Platform.isMacOS ||

0 commit comments

Comments
 (0)