feat: Flutter V2 Gen1 Docs Update

cspell.json

@@ -1126,6 +1126,7 @@
     "resolver's",
     "resourcename",
     "Resources.S3Bucket.Properties.BucketName",
+    "respectprimarykeyattributesonconnectionfield",
     "RESTAPI",
     "RESTENDPOINT",
     "resubscription",

redirects.json

@@ -10178,5 +10178,10 @@
 		"source": "/gen1/react/reference/cli-commands/",
 		"target": "/gen1/react/tools/cli/commands/",
 		"status": "301"
-	}
+	},
+  {
+    "source": "/gen1/flutter/build-a-backend/storage/move/",
+		"target": "/gen1/flutter/prev/build-a-backend/storage/move/",
+		"status": "301"
+  }
 ]

src/components/Breadcrumbs/index.tsx

@@ -21,7 +21,7 @@ const overrides = {
   '/gen1/javascript/prev': 'V5',
   '/gen1/swift/prev': 'V1',
   '/gen1/android/prev': 'V1',
-  '/gen1/flutter/prev': 'V0',
+  '/gen1/flutter/prev': 'V1',
   '/gen1/react/prev': 'V5',
   '/gen1/react-native/prev': 'V5',
   '/gen1/angular/prev': 'V5',

src/constants/feature-lists-data.ts

@@ -266,12 +266,6 @@ const featureListData = {
               'Upload and download files to and from cloud storage with advanced controls like pausing and resuming upload operations.',
             linkText: 'Upload and Download files',
             link: 'build-a-backend/storage/upload/'
-          },
-          {
-            content:
-              'Manage content through APIs for listing, accessing, and manipulating files. Set file permission levels, configure automatic events and triggers, and more.',
-            linkText: 'Advanced file operations and access control',
-            link: 'build-a-backend/storage/configure-access/'
           }
         ],
         heading: 'Storage'

src/data/platforms.ts

@@ -49,8 +49,8 @@ export const PLATFORM_VERSIONS = {
     current: 'v2'
   },
   flutter: {
-    prev: 'v0',
-    current: 'v1'
+    prev: 'v1',
+    current: 'v2'
   },
   javascript: {
     prev: 'v5',

src/directory/directory.mjs

@@ -1284,9 +1284,6 @@ export const directory = {
                     {
                       path: 'src/pages/gen1/[platform]/build-a-backend/storage/copy/index.mdx'
                     },
-                    {
-                      path: 'src/pages/gen1/[platform]/build-a-backend/storage/move/index.mdx'
-                    },
                     {
                       path: 'src/pages/gen1/[platform]/build-a-backend/storage/remove/index.mdx'
                     },
@@ -2362,6 +2359,9 @@ export const directory = {
                         {
                           path: 'src/pages/gen1/[platform]/prev/build-a-backend/storage/copy/index.mdx'
                         },
+                        {
+                          path: 'src/pages/gen1/[platform]/prev/build-a-backend/storage/move/index.mdx'
+                        },
                         {
                           path: 'src/pages/gen1/[platform]/prev/build-a-backend/storage/remove/index.mdx'
                         },

src/fragments/lib-v1/analytics/flutter/getting-started/10_preReq.mdx

@@ -1,5 +1,3 @@
-- [Install and configure Amplify CLI](/gen1/[platform]/tools/cli/start/set-up-cli/)
-- A Flutter application targeting Flutter SDK >= 2.10.0 (stable version) with Amplify libraries integrated
-  - An iOS configuration targeting at least iOS 11.0
-  - An Android configuration targeting at least Android API level 21 (Android 5.0) or above
-  - For a full example please follow the [project setup walkthrough](/gen1/[platform]/prev/start/project-setup/create-application/)
+* [Install and configure Amplify CLI](/gen1/[platform]/tools/cli/start/set-up-cli/)
+
+Amplify Flutter requires a minimum target platform for iOS (13.0), Android (API level 24), and macOS (10.15). Additional setup is required for some target platforms. Please see the [platform setup](/gen1/[platform]/prev/start/project-setup/platform-setup/) guide for more details on platform specific setup.

src/fragments/lib-v1/analytics/flutter/getting-started/20_installLib.mdx

@@ -5,14 +5,8 @@ In your Flutter project directory, open **pubspec.yaml**.
 Add Analytics by adding these libraries into your dependencies block:
 
 ```yaml
-environment:
-  sdk: '>=2.15.0 <3.0.0'
-
 dependencies:
-  # Should already be added during Project Setup walkthrough
-  amplify_flutter: ^0.6.0
-
-  # Add these lines in `dependencies` if you have not added it earlier during the Project Setup
-  amplify_auth_cognito: ^0.6.0
-  amplify_analytics_pinpoint: ^0.6.0
+  amplify_analytics_pinpoint: ^1.0.0
+  amplify_auth_cognito: ^1.0.0
+  amplify_flutter: ^1.0.0
 ```

src/fragments/lib-v1/analytics/flutter/getting-started/30_initAnalytics.mdx

@@ -16,6 +16,12 @@ Future<void> _configureAmplify() async {
 }
 ```
 
+<Callout>
+
+When running your app on macOS you will need to enable keychain sharing in Xcode, as described in the [Project setup guide](/gen1/[platform]/prev/start/project-setup/platform-setup/#enable-keychain).
+
+</Callout>
+
 Make sure that the `amplifyconfiguration.dart` file generated in the project setup is included and sent to `Amplify.configure`:
 
 ```dart

src/fragments/lib-v1/analytics/flutter/getting-started/40_record.mdx

@@ -6,7 +6,7 @@ To record an event, create an `AnalyticsEvent` and call `Amplify.Analytics.recor
 Future<void> trackEventsWithProperties() async {
   final event = AnalyticsEvent('test');
 
-  event.properties
+  event.customProperties
     ..addBoolProperty('boolKey', true)
     ..addDoubleProperty('doubleKey', 10)
     ..addIntProperty('intKey', 10)

src/fragments/lib-v1/analytics/flutter/identifyuser.mdx

@@ -2,7 +2,7 @@ This call sends information that you have specified about a user to Amazon Pinpo
 
 You can get the current user's ID from the Amplify Auth category as shown per the Auth category documentation. Be sure to have it ready before you set it as shown below (Check out the [Authentication Getting Started](/gen1/[platform]/prev/build-a-backend/auth/set-up-auth/) guide for detailed explanation).
 
-If you have asked for location access and received permission, you can also provide that in `AnalyticsUserProfileLocation`.
+If you have asked for location access and received permission, you can also provide that in `UserProfileLocation`
 
 ```dart
 Future<void> addAnalyticsWithLocation({
@@ -12,27 +12,33 @@ Future<void> addAnalyticsWithLocation({
   required String phoneNumber,
   required int age,
 }) async {
-  final location = AnalyticsUserProfileLocation()
-    ..latitude = 47.606209
-    ..longitude = -122.332069
-    ..postalCode = '98122'
-    ..city = 'Seattle'
-    ..region = 'WA'
-    ..country = 'USA';
-
-  final properties = AnalyticsProperties()
-    ..addStringProperty('phoneNumber', phoneNumber)
-    ..addIntProperty('age', age);
-
-  final userProfile = AnalyticsUserProfile()
-    ..name = name
-    ..email = email
-    ..location = location
-    ..properties = properties;
+  final userProfile = UserProfile(
+    name: name,
+    email: email,
+    location: const UserProfileLocation(
+      latitude: 47.606209,
+      longitude: -122.332069,
+      postalCode: '98122',
+      city: 'Seattle',
+      region: 'WA',
+      country: 'USA',
+    ),
+    customProperties: CustomProperties()
+      ..addStringProperty('phoneNumber', phoneNumber)
+      ..addIntProperty('age', age),
+  );
 
   await Amplify.Analytics.identifyUser(
     userId: userId,
     userProfile: userProfile,
   );
 }
 ```
+
+Sending user information allows you to associate a user to their user profile and activities or actions in your app.  The user's actions and attributes can also tracked across devices and platforms by using the same `userId`.  
+
+Some scenarios for identifying a user and their associated app activities are:
+* When a user completes app sign up
+* When a user completes sign in process
+* When a user launches your app
+* When a user modifies or updates their user profile

src/fragments/lib-v1/analytics/flutter/record.mdx

@@ -6,13 +6,13 @@ The Amplify analytics plugin also makes it easy to record custom events within t
 Future<void> recordCustomEvent() async {
   final event = AnalyticsEvent('PasswordReset');
 
-  event.properties
+  event.customProperties
     ..addStringProperty('Channel', 'SMS')
     ..addBoolProperty('Successful', true);
 
   // You can also add the properties one by one like the following
-  event.properties.addIntProperty('ProcessDuration', 792);
-  event.properties.addDoubleProperty('doubleKey', 120.3);
+  event.customProperties.addIntProperty('ProcessDuration', 792);
+  event.customProperties.addDoubleProperty('doubleKey', 120.3);
 
   await Amplify.Analytics.recordEvent(event: event);
 }
@@ -28,6 +28,33 @@ However, it can take upwards of 30 minutes for the event to display in the Filte
 
 ## Flush events
 
+Events have default configuration to flush out to the network every 30 seconds. If you would like to change this, update `amplifyconfiguration.dart` with the value in milliseconds you would like for `autoFlushEventsInterval`. This configuration will flush events every 10 seconds:
+
+```json
+{
+  "UserAgent": "aws-amplify-cli/2.0",
+  "Version": "1.0",
+  "analytics": {
+    "plugins": {
+      "awsPinpointAnalyticsPlugin": {
+        "pinpointAnalytics": {
+          "appId": "AppID",
+          "region": "Region"
+        },
+        "pinpointTargeting": {
+          "region": "Region"
+        },
+        "autoFlushEventsInterval": 10
+      }
+    }
+  }
+}
+```
+
+> **Note**
+>
+> Setting `autoFlushEventsInterval` to 0 will **disable** the automatic flush of events and you will be responsible for submitting them.
+
 To manually flush events, call:
 
 ```dart
@@ -40,7 +67,7 @@ You can register global properties which will be sent along with all invocations
 
 ```dart
 Future<void> registerGlobalProperties() async {
-  final properties = AnalyticsProperties()
+  final properties = CustomProperties()
     ..addStringProperty('AppStyle', 'DarkMode');
   await Amplify.Analytics.registerGlobalProperties(
     globalProperties: properties,
@@ -57,3 +84,11 @@ Future<void> unregisterGlobalProperties() async {
   );
 }
 ```
+
+Furthermore, you can remove all global properties by calling `unregisterGlobalProperties` without `propertyNames`:
+
+```dart
+Future<void> unregisterAllGlobalProperties() async {
+  await Amplify.Analytics.unregisterGlobalProperties();
+}
+```

src/fragments/lib-v1/auth/android/signin/20_confirmSignUp.mdx

@@ -57,3 +57,9 @@ RxAmplify.Auth.confirmSignUp("username", "the code you received via email")
 
 </Block>
 </BlockSwitcher>
+
+You will know the sign up flow is complete if you see the following in your console window:
+
+```console
+Confirm signUp succeeded
+```

src/fragments/lib-v1/auth/android/signin/30_signIn.mdx

@@ -55,3 +55,9 @@ RxAmplify.Auth.signIn("username", "password")
 
 </Block>
 </BlockSwitcher>
+
+You will know the sign in flow is complete if you see the following in your console window:
+
+```console
+Sign in succeeded
+```

src/fragments/lib-v1/auth/common/device_features/common.mdx

@@ -101,4 +101,4 @@ import flutter13 from '/src/fragments/lib-v1/auth/flutter/device_features/40_tra
 
 When using the federated OAuth flow with Cognito User Pools, the [device tracking and remembering](https://aws.amazon.com/blogs/mobile/tracking-and-remembering-devices-using-amazon-cognito-your-user-pools/) features are currently not available within the library.
 
-<Fragments fragments={{ flutter: flutter13 }} />
+<Fragments fragments={{ flutter: flutter13 }} />