googleidentity v7.1.1

Author: marchbold

docs/googleidentity/_includes/add-apm-appdescriptor.mdx

@@ -18,3 +18,35 @@ You should backup your application descriptor before running this command to ens
 If you need to insert custom data into these sections see the guides for [Android](https://github.com/airsdk/apm/wiki/Usage-Generate#android) and [iOS](https://github.com/airsdk/apm/wiki/Usage-Generate#ios)
 :::
 
+
+### Android Gradle Version 
+
+We have updated the required gradle version used to build your application to be higher than the default AIR currently uses (April 2025). 
+
+To specify a higher version add the following to your android node in your application descriptor:
+
+```xml
+<android>
+    <gradleVersion>8.9</gradleVersion>
+    <androidGradlePluginVersion>8.7.3</androidGradlePluginVersion>
+
+  ...
+</android>
+```
+
+If you don't do this you will see the following error when building your application:
+
+```
+Unexpected failure: Unable to run java: com.adobe.air.ADTException: gradle tool failed: 
+FAILURE: Build failed with an exception.
+
+...
+
+   > BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 65
+```
+
+:::note
+June 2025: This is not currently automatically handled by `apm` so you will need to add this manually to your application descriptor.
+
+We are working on an update to handle this.
+:::

docs/googleidentity/_includes/add-manual-appdescriptor.mdx

@@ -41,6 +41,38 @@ Making requests and accessing the Google Identity functionality requires the som
 </manifest>
 ```
 
+#### Android Gradle Version 
+
+We have updated the required gradle version used to build your application to be higher than the default AIR currently uses (April 2025). 
+
+To specify a higher version add the following to your android node in your application descriptor:
+
+```xml
+<android>
+    <gradleVersion>8.9</gradleVersion>
+    <androidGradlePluginVersion>8.7.3</androidGradlePluginVersion>
+
+  ...
+</android>
+```
+
+If you don't do this you will see the following error when building your application:
+
+```
+Unexpected failure: Unable to run java: com.adobe.air.ADTException: gradle tool failed: 
+FAILURE: Build failed with an exception.
+
+...
+
+   > BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 65
+```
+
+:::note
+June 2025: This is not currently automatically handled by `apm` so you will need to add this manually to your application descriptor.
+
+We are working on an update to handle this.
+:::
+
 
 ### iOS 
 

docs/googleidentity/changelog.md

@@ -1,3 +1,25 @@
+### 2025.07.02 [v7.1.1]
+
+```
+## Setup Change
+
+There has been a slight change to the setup call, it will now perform a check if the user has previously 
+signed in successfully and start a silent sign in process. This ensures the `isSignedIn` flag is correct
+after setup. 
+
+Notes:
+- this makes the setup process asynchronous if you want to ensure the `isSignedIn` flag is correct
+- may present a UI ("signing you in") on Android if the user has signed in previously
+- can disable this new functionality by setting `options.attemptSilentSignIn = false;`
+
+### Updates
+
+feat(android): add ability to automatically perform silent sign in at setup if previously signed in
+feat(ios): clean up sign in process at setup
+feat: add attemptSilentSignIn parameter to options to control auto sign in attempt at setup
+feat(android): update androidx credentials sdk to v1.5.0 
+```
+
 ### 2025.01.20 [v7.0.1]
 
 ```

docs/googleidentity/images/silent-sign-in-ui.png

@@ -6,7 +6,7 @@ sidebar_label: Setup
 
 ## Setup the extension
 
-Next you need to setup the platform using your Google API client ID and specify any additional 
+You need to setup the platform using your Google API client ID and specify any additional 
 options such as scopes you require:
 
 At a minimum you will need to specify the iOS and Android client IDs:
@@ -25,7 +25,50 @@ The options here specify the permissions and scopes that you require from your u
 
 For more information on these options see the [Google Identity Options](google-identity-options.md) section.
 
-After setup you may wish to attempt to [sign in silently](signing-in.md#sign-in-silently).
+
+This call will be asynchronous, certain situations require checks that perform asynchronous operations. 
+You should await the `GoogleIdentityEvent.SETUP_COMPLETE` event before continuing with any other functionality of the extension:
+
+```actionscript
+GoogleIdentity.service.addEventListener( GoogleIdentityEvent.SETUP_COMPLETE, setupCompleteHandler );
+
+function setupCompleteHandler( event:GoogleIdentityEvent ):void 
+{
+	// Setup has completed
+}
+```
+
+
+### Automatic silent sign in
+
+The setup process will perform an automatic silent sign in if the user has previously signed in successfully. 
+This process is needed to ensure the `isSignedIn` flag is correct after setup. 
+
+The means your user may be presented a view showing something like "signing you in" as part of the `setup()` call. 
+
+![](images/silent-sign-in-ui.png)
+
+
+:::note 
+You can disable this functionality by changing the `attemptSilentSignIn` value in the options:
+
+```actionscript
+var options:GoogleIdentityOptions = new GoogleIdentityOptionsBuilder()
+	
+	...
+
+	.setAttemptSilentSignIn( false )
+	.build();
+```
+
+This will mean you can manage this process yourself, storing a flag for when users have successfully signed in and then performing a silent sign in when it suits your application.
+
+**If you disable this process the `isSignedIn` flag may be incorrect after `setup()`**
+
+More information on how to [sign in silently](signing-in.md#sign-in-silently).
+:::
+
+
 
 
 

docs/googleidentity/setup.md

@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!-- saved from url=(0014)about:internet --><html>
    <head>
       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-      <title>All Classes - distriqt // GoogleIdentity</title>
+      <title>All Classes - GoogleIdentity</title>
       <base target="classFrame">
       <link rel="stylesheet" href="style.css" type="text/css" media="screen">
       <link rel="stylesheet" href="print.css" type="text/css" media="print">
@@ -34,4 +34,4 @@ <h3><a href="class-summary.html" target="classFrame" style="color:black">All Cla
       </table>
    </body>
 </html>
-<!--Copyright distriqt 2016<br/>Mon Jan 20 2025, 11:08 AM +10:00  -->
+<!--Copyright Michael Archbold 2025<br/>Wed Jul 2 2025, 09:27 PM +10:00  -->