googleidentity v7.0.0

Author: marchbold

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

@@ -28,33 +28,14 @@ Making requests and accessing the Google Identity functionality requires the som
 ```xml
 <manifest android:installLocation="auto">
 
-	<uses-sdk android:minSdkVersion="19" android:targetSdkVersion="33"/>
+	<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34"/>
 
 	<uses-permission android:name="android.permission.INTERNET"/>
-	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 
 	<application>
-	
-		<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
-
-		<activity
-			android:name="com.google.android.gms.common.api.GoogleApiActivity"
-			android:exported="false"
-			android:theme="@android:style/Theme.Translucent.NoTitleBar" />
-				
-
-		<activity
-			android:name="com.google.android.gms.auth.api.signin.internal.SignInHubActivity"
-			android:excludeFromRecents="true"
-			android:exported="false"
-			android:theme="@android:style/Theme.Translucent.NoTitleBar" />
-		<service
-			android:name="com.google.android.gms.auth.api.signin.RevocationBoundService"
-			android:exported="true"
-			android:permission="com.google.android.gms.auth.api.signin.permission.REVOCATION_NOTIFICATION" 
-			android:visibleToInstantApps="true" />
-
 
+		<activity android:name="com.distriqt.core.auth.AuthorisationActivity" android:exported="false" android:theme="@android:style/Theme.Translucent.NoTitleBar"/>
+	
 	</application>
 
 </manifest>
@@ -105,6 +86,7 @@ The `URL_NAME` should be your application identifier, eg: `com.distriqt.test`
 See the example application for our test application implementation.
 
 
+
 ##### Optional: Configure backend authentication
 
 If you need to get users' ID tokens for backend authentication, also set the `GIDServerClientID` key in your app's Info.plist file.

docs/googleidentity/changelog.md

@@ -1,3 +1,13 @@
+### 2024.12.05 [v7.0.0]
+
+```
+See the migration guide: https://docs.airnativeextensions.com/docs/googleidentity/migrating-to-v7.0
+
+feat(android): update from google sign in to new androidx credentials manager (resolves https://github.com/distriqt/ANE-GoogleIdentity/issues/75, resolves https://github.com/distriqt/ANE-GoogleIdentity/issues/76)
+feat(android): move to gradle dependencies
+feat(ios): update google sign in lib to v8.0.0
+```
+
 ### 2024.05.16 [v6.0.0]
 
 ```

docs/googleidentity/google-identity-options.md

@@ -31,13 +31,16 @@ YOU DO NOT NEED TO USE THE *ANDROID CLIENT*. Android applications are identified
 
 The simplest method to correctly create your options for setup is to use the `GoogleIdentityOptionsBuilder`. This class contains helper functions to construct the options correctly for the `setup` of your application. The builder is setup in such a way that you can use a single code base and the builder will determine the correct values to use in the `GoogleIdentityOptions` instance based on the current platform of the device. This allows you to simplify your code having one code base for both Android and iOS. If you wish more control you can use the direct accessors, `setClientID` and `setServerClientID`, which will ignore the current platform.
 
-As a minimum you will need to set the iOS Client ID:
+At a minimum you will need to specify the iOS and Android client IDs:
 
 ```actionscript
 var options:GoogleIdentityOptions = new GoogleIdentityOptionsBuilder()
-    .requestEmail()
+	.requestEmail()
 	.setIOSClientID( IOS_CLIENT_ID )
+	.setAndroidServerClientID( WEB_CLIENT_ID )
 	.build();
+
+GoogleIdentity.service.setup( options );
 ```
 
 

docs/googleidentity/migrating-to-v7.0.mdx

@@ -0,0 +1,79 @@
+---
+title: Migrating to v7.0
+---
+
+import Tabs from '@theme/Tabs'
+import TabItem from '@theme/TabItem'
+
+
+This latest release brings a number of updates to the extension particularly around the Android integration. 
+
+It also brings a complete rewrite of the Android implementation to use the latest Google credential and authorisiation libriaries. 
+
+The iOS implementation has been updated to v8.0.0 however the implementation remains largely unchanged. 
+
+
+
+
+## Android Integration 
+
+### Gradle Dependencies
+
+We have moved to using gradle dependencies within our extensions which will improve dependency resolution, reduce update times and improve compatibility with other extensions.
+
+This also reduces the amount of work required to manually integrate the extensions, reducing the additions to the manifest in your application descriptor.
+
+We highly recommend using the [apm](https://airnativeextensions.com/docs/using-apm) tool to manage the integration of the extensions in your application and to generate your application descriptor:
+
+```bash
+apm update
+apm generate app-descriptor
+```
+
+However, you can still integrate the manifest additions manually if you prefer. With this update we recommend starting fresh as there have been a lot of entries to be removed.
+
+
+
+### Updating code 
+
+The main changes required to update your code are around the setup of the extension. 
+You are now required to supply the web client ID to sign in with Google on Android so you must ensure you call `setAndroidServerClientID()` with your web client id:
+
+```actionscript
+var options:GoogleIdentityOptions = new GoogleIdentityOptionsBuilder()
+	.requestEmail()
+	.setIOSClientID( IOS_CLIENT_ID )
+
+    // Add the web client id for android
+	.setAndroidServerClientID( WEB_CLIENT_ID )
+	
+    .build();
+
+GoogleIdentity.service.setup( options );
+```
+
+
+### Updating the manifest 
+
+You can simplify the manifest now as well as the gradle implementation will add a significant amount of the required manifest entries for you. 
+If you use the `apm` tool to generate your application descriptor you will see the manifest entries are significantly reduced and simply running the commands above will update the manifest for you.
+
+If you manually update the manifest then, as mentioned above, we recommend starting fresh as there have been a lot of entries to be removed.
+The minimum manifest additions now looks like the following:
+
+```xml
+<manifest android:installLocation="auto">
+
+	<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34"/>
+
+	<uses-permission android:name="android.permission.INTERNET"/>
+	
+	<application>
+			
+		<activity android:name="com.distriqt.core.auth.AuthorisationActivity" android:exported="false" android:theme="@android:style/Theme.Translucent.NoTitleBar"/>
+	
+	</application>
+
+</manifest>
+```
+

docs/googleidentity/setup.md

@@ -9,12 +9,13 @@ sidebar_label: Setup
 Next 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 client ID:
+At a minimum you will need to specify the iOS and Android client IDs:
 
 ```actionscript
 var options:GoogleIdentityOptions = new GoogleIdentityOptionsBuilder()
 	.requestEmail()
 	.setIOSClientID( IOS_CLIENT_ID )
+	.setAndroidServerClientID( WEB_CLIENT_ID )
 	.build();
 
 GoogleIdentity.service.setup( options );
@@ -30,6 +31,11 @@ After setup you may wish to attempt to [sign in silently](signing-in.md#sign-in-
 
 ## Games Signin
 
+:::danger 
+This process is no longer supported. Please reach out to us if you require this integration.
+:::
+
+
 If you are planning to use Google Play Games on Android in your application then you can use this ANE to handle the signin process for games rather than handling two authentication processes. Additionally this ANE gives you more control over the sign in options and adding extra scopes that you don't get with the Game Services ANE. 
 
 To do this we have added some default functionality to make the setup process simpler. Simply pass the `GoogleIdentityOptions.DEFAULT_GAMES_SIGN_IN` to the builder constructor and then set any additional options as required. 

sidebars.js

@@ -1766,6 +1766,7 @@ module.exports = {
     {
       Help: [
         "googleidentity/troubleshooting",
+        "googleidentity/migrating-to-v7.0",
         "googleidentity/migrating-to-androidx",
         "googleidentity/migrating-from-version-1",
       ],

static/asdocs/googleidentity/all-classes.html

@@ -34,4 +34,4 @@ <h3><a href="class-summary.html" target="classFrame" style="color:black">All Cla
       </table>
    </body>
 </html>
-<!--Copyright distriqt 2016<br/>Thu May 16 2024, 09:07 PM +10:00  -->
+<!--Copyright distriqt 2016<br/>Thu Dec 5 2024, 09:53 PM +10:00  -->

static/asdocs/googleidentity/all-index-A.html

@@ -14,4 +14,4 @@
 		 The OAuth2 access token to access Google services 
 		 </td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/googleidentity/GoogleIdentityOptionsBuilder.html#addScope()" onclick="javascript:loadClassListFrame('com/distriqt/extension/googleidentity/class-list.html');">addScope</a>(scope:String) &mdash; method,  class com.distriqt.extension.googleidentity.<a href="com/distriqt/extension/googleidentity/GoogleIdentityOptionsBuilder.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/googleidentity/class-list.html');">GoogleIdentityOptionsBuilder</a></td></tr><tr><td width="20"></td><td></td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/googleidentity/GoogleUser.html#authentication" onclick="javascript:loadClassListFrame('com/distriqt/extension/googleidentity/class-list.html');">authentication</a> &mdash; Property, class com.distriqt.extension.googleidentity.<a href="com/distriqt/extension/googleidentity/GoogleUser.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/googleidentity/class-list.html');">GoogleUser</a></td></tr><tr><td width="20"></td><td>
 		 The authentication object for the user
-		 </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><font color="black" size="10px" style="bold">A</font>&nbsp;&nbsp;<a href="all-index-B.html" onclick="javascript:loadClassListFrame('index-list.html');">B</a>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://distriqt.com" target="_top">distriqt</a> 2016</footer><br/>Thu May 16 2024, 09:07 PM +10:00  </center></div></body></html><!--Copyright distriqt 2016<br/>Thu May 16 2024, 09:07 PM +10:00  -->
+		 </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><font color="black" size="10px" style="bold">A</font>&nbsp;&nbsp;<a href="all-index-B.html" onclick="javascript:loadClassListFrame('index-list.html');">B</a>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://distriqt.com" target="_top">distriqt</a> 2016</footer><br/>Thu Dec 5 2024, 09:53 PM +10:00  </center></div></body></html><!--Copyright distriqt 2016<br/>Thu Dec 5 2024, 09:53 PM +10:00  -->