[google_sign_in] Add Android account name field as optional

packages/extension_google_sign_in_as_googleapis_auth/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.1.0
 
+* Add a sign-in field to allow Android clients to explicitly specify an account name. This capability is only available within Android for the underlying libraries.
 * Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
 
 ## 2.0.12

packages/extension_google_sign_in_as_googleapis_auth/example/pubspec.yaml

@@ -26,3 +26,7 @@ dev_dependencies:
 
 flutter:
   uses-material-design: true
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  google_sign_in_platform_interface: {path: ../../../packages/google_sign_in/google_sign_in_platform_interface}

packages/extension_google_sign_in_as_googleapis_auth/pubspec.yaml

@@ -8,7 +8,7 @@ name: extension_google_sign_in_as_googleapis_auth
 description: A bridge package between google_sign_in and googleapis_auth, to create Authenticated Clients from google_sign_in user credentials.
 repository: https://github.com/flutter/packages/tree/main/packages/extension_google_sign_in_as_googleapis_auth
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+extension_google_sign_in_as_googleapis_auth%22
-version: 2.0.12
+version: 2.1.0
 
 environment:
   sdk: ^3.4.0
@@ -33,3 +33,7 @@ topics:
 false_secrets:
  - example/android/app/google-services.json
  - example/ios/Runner/GoogleService-Info.plist
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+  google_sign_in_platform_interface: {path: ../../packages/google_sign_in/google_sign_in_platform_interface}

packages/google_sign_in/google_sign_in/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 6.3.0
 
+* Add a sign-in field to allow Android clients to explicitly specify an account name. This capability is only available within Android for the underlying libraries.
 * Updates minimum supported SDK version to Flutter 3.22/Dart 3.4.
 
 ## 6.2.2

packages/google_sign_in/google_sign_in/example/pubspec.yaml

@@ -28,3 +28,8 @@ dev_dependencies:
 
 flutter:
   uses-material-design: true
+
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+   {google_sign_in_android: {path: ../../../../packages/google_sign_in/google_sign_in_android}, google_sign_in_ios: {path: ../../../../packages/google_sign_in/google_sign_in_ios}, google_sign_in_platform_interface: {path: ../../../../packages/google_sign_in/google_sign_in_platform_interface}}

packages/google_sign_in/google_sign_in/lib/google_sign_in.dart

@@ -187,6 +187,7 @@ class GoogleSignIn {
     this.clientId,
     this.serverClientId,
     this.forceCodeForRefreshToken = false,
+    this.forceAccountName,
   }) {
     // Start initializing.
     if (kIsWeb) {
@@ -263,6 +264,9 @@ class GoogleSignIn {
   /// Force the authorization code to be valid for a refresh token every time. Only needed on Android.
   final bool forceCodeForRefreshToken;
 
+  /// Explicitly specifies the account name to be used in sign-in. Only used on Android.
+  final String? forceAccountName;
+
   final StreamController<GoogleSignInAccount?> _currentUserController =
       StreamController<GoogleSignInAccount?>.broadcast();
 
@@ -317,6 +321,7 @@ class GoogleSignIn {
       clientId: clientId,
       serverClientId: serverClientId,
       forceCodeForRefreshToken: forceCodeForRefreshToken,
+      forceAccountName: forceAccountName,
     ));
 
     unawaited(GoogleSignInPlatform.instance.userDataEvents

packages/google_sign_in/google_sign_in/pubspec.yaml

@@ -3,7 +3,7 @@ description: Flutter plugin for Google Sign-In, a secure authentication system
   for signing in with a Google account.
 repository: https://github.com/flutter/packages/tree/main/packages/google_sign_in/google_sign_in
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+google_sign_in%22
-version: 6.2.2
+version: 6.3.0
 
 environment:
   sdk: ^3.4.0
@@ -49,3 +49,8 @@ false_secrets:
   - /example/ios/RunnerTests/GoogleService-Info.plist
   - /example/ios/RunnerTests/GoogleSignInTests.m
   - /example/macos/Runner/Info.plist
+
+# FOR TESTING AND INITIAL REVIEW ONLY. DO NOT MERGE.
+# See https://github.com/flutter/flutter/blob/master/docs/ecosystem/contributing/README.md#changing-federated-plugins
+dependency_overrides:
+   {google_sign_in_android: {path: ../../../packages/google_sign_in/google_sign_in_android}, google_sign_in_ios: {path: ../../../packages/google_sign_in/google_sign_in_ios}, google_sign_in_platform_interface: {path: ../../../packages/google_sign_in/google_sign_in_platform_interface}}

packages/google_sign_in/google_sign_in/test/google_sign_in_test.dart

@@ -113,6 +113,17 @@ void main() {
       verify(mockPlatform.signIn());
     });
 
+    test('forceAccountName sent with init method call', () async {
+      final GoogleSignIn googleSignIn =
+          GoogleSignIn(forceAccountName: 'fakeEmailAddress@google.com');
+
+      await googleSignIn.signIn();
+
+      _verifyInit(mockPlatform,
+          forceAccountName: 'fakeEmailAddress@google.com');
+      verify(mockPlatform.signIn());
+    });
+
     test('signOut', () async {
       final GoogleSignIn googleSignIn = GoogleSignIn();
 
@@ -447,6 +458,7 @@ void _verifyInit(
   String? clientId,
   String? serverClientId,
   bool forceCodeForRefreshToken = false,
+  String? forceAccountName,
 }) {
   verify(mockSignIn.initWithParams(argThat(
     isA<SignInInitParameters>()
@@ -479,6 +491,11 @@ void _verifyInit(
           (SignInInitParameters p) => p.forceCodeForRefreshToken,
           'forceCodeForRefreshToken',
           forceCodeForRefreshToken,
+        )
+        .having(
+          (SignInInitParameters p) => p.forceAccountName,
+          'forceAccountName',
+          forceAccountName,
         ),
   )));
 }

packages/google_sign_in/google_sign_in_android/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 6.2.0
+
+* Add a sign-in field to allow Android clients to explicitly specify an account name. This capability is only available within Android for the underlying libraries.
+
 ## 6.1.35
 
 * Removes the dependency on the Guava library.

packages/google_sign_in/google_sign_in_android/android/src/main/java/io/flutter/plugins/googlesignin/GoogleSignInPlugin.java

@@ -255,6 +255,11 @@ public void init(@NonNull Messages.InitParams params) {
           optionsBuilder.setHostedDomain(params.getHostedDomain());
         }
 
+        String forceAccountName = params.getForceAccountName();
+        if (!isNullOrEmpty(forceAccountName)) {
+          optionsBuilder.setAccountName(forceAccountName);
+        }
+
         signInClient = googleSignInWrapper.getClient(context, optionsBuilder.build());
       } catch (Exception e) {
         throw new FlutterError(ERROR_REASON_EXCEPTION, e.getMessage(), null);

packages/google_sign_in/google_sign_in_android/android/src/main/java/io/flutter/plugins/googlesignin/Messages.java

@@ -156,6 +156,16 @@ public void setForceCodeForRefreshToken(@NonNull Boolean setterArg) {
       this.forceCodeForRefreshToken = setterArg;
     }
 
+    private @Nullable String forceAccountName;
+
+    public @Nullable String getForceAccountName() {
+      return forceAccountName;
+    }
+
+    public void setForceAccountName(@Nullable String setterArg) {
+      this.forceAccountName = setterArg;
+    }
+
     /** Constructor is non-public to enforce null safety; use Builder. */
     InitParams() {}
 
@@ -173,13 +183,20 @@ public boolean equals(Object o) {
           && Objects.equals(hostedDomain, that.hostedDomain)
           && Objects.equals(clientId, that.clientId)
           && Objects.equals(serverClientId, that.serverClientId)
-          && forceCodeForRefreshToken.equals(that.forceCodeForRefreshToken);
+          && forceCodeForRefreshToken.equals(that.forceCodeForRefreshToken)
+          && Objects.equals(forceAccountName, that.forceAccountName);
     }
 
     @Override
     public int hashCode() {
       return Objects.hash(
-          scopes, signInType, hostedDomain, clientId, serverClientId, forceCodeForRefreshToken);
+          scopes,
+          signInType,
+          hostedDomain,
+          clientId,
+          serverClientId,
+          forceCodeForRefreshToken,
+          forceAccountName);
     }
 
     public static final class Builder {
@@ -232,6 +249,14 @@ public static final class Builder {
         return this;
       }
 
+      private @Nullable String forceAccountName;
+
+      @CanIgnoreReturnValue
+      public @NonNull Builder setForceAccountName(@Nullable String setterArg) {
+        this.forceAccountName = setterArg;
+        return this;
+      }
+
       public @NonNull InitParams build() {
         InitParams pigeonReturn = new InitParams();
         pigeonReturn.setScopes(scopes);
@@ -240,19 +265,21 @@ public static final class Builder {
         pigeonReturn.setClientId(clientId);
         pigeonReturn.setServerClientId(serverClientId);
         pigeonReturn.setForceCodeForRefreshToken(forceCodeForRefreshToken);
+        pigeonReturn.setForceAccountName(forceAccountName);
         return pigeonReturn;
       }
     }
 
     @NonNull
     ArrayList<Object> toList() {
-      ArrayList<Object> toListResult = new ArrayList<>(6);
+      ArrayList<Object> toListResult = new ArrayList<>(7);
       toListResult.add(scopes);
       toListResult.add(signInType);
       toListResult.add(hostedDomain);
       toListResult.add(clientId);
       toListResult.add(serverClientId);
       toListResult.add(forceCodeForRefreshToken);
+      toListResult.add(forceAccountName);
       return toListResult;
     }
 
@@ -270,6 +297,8 @@ ArrayList<Object> toList() {
       pigeonResult.setServerClientId((String) serverClientId);
       Object forceCodeForRefreshToken = pigeonVar_list.get(5);
       pigeonResult.setForceCodeForRefreshToken((Boolean) forceCodeForRefreshToken);
+      Object forceAccountName = pigeonVar_list.get(6);
+      pigeonResult.setForceAccountName((String) forceAccountName);
       return pigeonResult;
     }
   }
@@ -512,6 +541,7 @@ public interface Result<T> {
     /** Failure case callback method for handling errors. */
     void error(@NonNull Throwable error);
   }
+
   /** Asynchronous error handling return type for nullable API method returns. */
   public interface NullableResult<T> {
     /** Success case callback method for handling returns. */
@@ -520,6 +550,7 @@ public interface NullableResult<T> {
     /** Failure case callback method for handling errors. */
     void error(@NonNull Throwable error);
   }
+
   /** Asynchronous error handling return type for void API method returns. */
   public interface VoidResult {
     /** Success case callback method for handling returns. */
@@ -528,33 +559,43 @@ public interface VoidResult {
     /** Failure case callback method for handling errors. */
     void error(@NonNull Throwable error);
   }
+
   /** Generated interface from Pigeon that represents a handler of messages from Flutter. */
   public interface GoogleSignInApi {
     /** Initializes a sign in request with the given parameters. */
     void init(@NonNull InitParams params);
+
     /** Starts a silent sign in. */
     void signInSilently(@NonNull Result<UserData> result);
+
     /** Starts a sign in with user interaction. */
     void signIn(@NonNull Result<UserData> result);
+
     /** Requests the access token for the current sign in. */
     void getAccessToken(
         @NonNull String email, @NonNull Boolean shouldRecoverAuth, @NonNull Result<String> result);
+
     /** Signs out the current user. */
     void signOut(@NonNull VoidResult result);
+
     /** Revokes scope grants to the application. */
     void disconnect(@NonNull VoidResult result);
+
     /** Returns whether the user is currently signed in. */
     @NonNull
     Boolean isSignedIn();
+
     /** Clears the authentication caching for the given token, requiring a new sign in. */
     void clearAuthCache(@NonNull String token);
+
     /** Requests access to the given scopes. */
     void requestScopes(@NonNull List<String> scopes, @NonNull Result<Boolean> result);
 
     /** The codec used by GoogleSignInApi. */
     static @NonNull MessageCodec<Object> getCodec() {
       return PigeonCodec.INSTANCE;
     }
+
     /**
      * Sets up an instance of `GoogleSignInApi` to handle messages through the `binaryMessenger`.
      */