feat: update to 17.5.0 and backgrounding support

.gitignore

@@ -1,4 +1,5 @@
 .DS_Store
+*.orig
 
 node_modules/
 

Jenkinsfile

@@ -4,6 +4,6 @@ library 'pipeline-library'
 def isMaster = env.BRANCH_NAME.equals('master')
 
 buildModule {
-	sdkVersion = '9.0.0.v20200205134519' // TODO: Change to 9.0.0.GA once released
+	sdkVersion = '9.0.0.GA'
 	npmPublish = isMaster
 }

android/Resources/ti.playservices/ti.playservices.bootstrap.js

@@ -1,26 +1,41 @@
-exports.execute = (finished) => {
-	// Check if Google Play Services validation is enabled on startup. (Enabled by default.)
-	// Can be disabled via "tiapp.xml" entry:
-	// <ti:app>
-	//   <property name="ti.playservices.validate.on.startup" type="bool">false</property>
-	// </ti:app>
-	const isEnabled = Ti.App.Properties.getBool('ti.playservices.validate.on.startup', true);
-	if (!isEnabled) {
-		finished();
-		return;
-	}
-
-	// Check if Google Play Services is available (ie: installed/updated) on devices that support it.
-	// If not available, will display Google's standard dialog asking end-user to install/update it.
+/**
+ * Checks if Google Play Services is available (ie: installed/updated) on devices that support it.
+ * If not available, will display Google's standard dialog asking end-user to install/update it.
+ * @param {Function} finished Callback to be invoked when this check has finished.
+ */
+function showUI(finished) {
 	try {
 		const PlayServices = require('ti.playservices');
+
+		// Check if Play Services needs to be installed, updated, or enabled.
+		let isUpdateNeeded = false;
+		const resultCode = PlayServices.isGooglePlayServicesAvailable();
+		if (resultCode === PlayServices.RESULT_SUCCESS) {
+			// Play Services is installed/updated.
+			const versionString = PlayServices.GOOGLE_PLAY_SERVICES_VERSION_CODE;
+			Ti.API.info(`ti.playservices: Google Play Services is available. (version: ${versionString})`);
+			isUpdateNeeded = false;
+		} else {
+			// Play Services needs to be installed, updated, or enabled.
+			// If invalid, then device does not support Google Play (such as Amazon devices) or it's a hacked version.
+			const errorString = PlayServices.getErrorString(resultCode);
+			Ti.API.info(`ti.playservices: Google Play Services is unavailable. (${errorString})`);
+			isUpdateNeeded = (resultCode !== PlayServices.RESULT_SERVICE_INVALID);
+		}
+
+		// Stop here if update is not required.
+		if (!isUpdateNeeded) {
+			finished();
+			return;
+		}
+
+		// Display Google's update dialog.
 		PlayServices.makeGooglePlayServicesAvailable((e) => {
 			if (e.success) {
-				// Play Services is installed/updated. Proceed to load "app.js".
+				// Play Services is installed/updated.
 				finished();
 			} else if (e.code === PlayServices.RESULT_SERVICE_INVALID) {
 				// Device does not support Google Play (such as an Amazon device) or it's a hacked version.
-				// Proceed to load "app.js". (It's impossible to install on device anyways.)
 				finished();
 			} else {
 				// Exit the app, because the end-user refused to install/update Play Services when prompted.
@@ -34,4 +49,20 @@ exports.execute = (finished) => {
 		Ti.API.error(err);
 		finished();
 	}
-};
+}
+
+// Only inject this bootstrap's UI on startup if Google Play Services validation is enabled.
+// Can be disabled via "tiapp.xml" entry:
+// <ti:app>
+//   <property name="ti.playservices.validate.on.startup" type="bool">false</property>
+// </ti:app>
+if (Ti.App.Properties.getBool('ti.playservices.validate.on.startup', true)) {
+	if (Ti.UI.hasSession !== undefined) {
+		// Titanium supports backgrounding and showing multiple UI sessions with a single JS runtime instance.
+		// Show bootstrap's UI every time a new UI session has been created.
+		exports.showUI = showUI;
+	} else {
+		// Older Titanium versions will only run this bootstrap once per JS runtime instance.
+		exports.execute = showUI;
+	}
+}

android/build.gradle

@@ -1,9 +1,9 @@
 
 dependencies {
 	// Needed to check for Google Play Services availability on device.
-	implementation 'com.google.android.gms:play-services-base:17.1.0'
+	implementation 'com.google.android.gms:play-services-base:17.5.0'
 
 	// App devs expect adding "ti.playservices" will enable "Fused Location" support to "Ti.Gelocation" APIs.
 	// So, we must add this library to support it, even though this module doesn't use this library at all.
-	implementation 'com.google.android.gms:play-services-location:17.0.0'
+	implementation 'com.google.android.gms:play-services-location:17.1.0'
 }

android/manifest

@@ -2,7 +2,7 @@
 # this is your module manifest and used by Titanium
 # during compilation, packaging, distribution, etc.
 #
-version: 17.1.1
+version: 17.5.0
 apiversion: 4
 architectures: arm64-v8a armeabi-v7a x86 x86_64
 description: Titanium Google Play Services module.
@@ -15,4 +15,3 @@ moduleid: ti.playservices
 guid: 32184149-411f-436b-92a8-c6ddb98a5fb6
 platform: android
 minsdk: 9.0.0
-commonjs: true

android/src/ti/playservices/PlayServicesModule.java

@@ -6,11 +6,17 @@
  */
 package ti.playservices;
 
+import android.app.Activity;
 import com.google.android.gms.common.ConnectionResult;
 import com.google.android.gms.common.GoogleApiAvailability;
+import com.google.android.gms.tasks.Task;
+import java.util.concurrent.CancellationException;
+import org.appcelerator.kroll.KrollDict;
+import org.appcelerator.kroll.KrollFunction;
 import org.appcelerator.kroll.KrollModule;
 import org.appcelerator.kroll.annotations.Kroll;
 import org.appcelerator.titanium.TiApplication;
+import org.appcelerator.titanium.TiC;
 
 @Kroll.module(name = "PlayServices", id = "ti.playservices")
 public class PlayServicesModule extends KrollModule
@@ -47,7 +53,7 @@ public PlayServicesModule()
 	@Kroll.method
 	public int isGooglePlayServicesAvailable()
 	{
-		return this.api.isGooglePlayServicesAvailable(TiApplication.getAppRootOrCurrentActivity());
+		return this.api.isGooglePlayServicesAvailable(TiApplication.getInstance());
 	}
 
 	@Kroll.method
@@ -56,6 +62,55 @@ public boolean isUserResolvableError(int code)
 		return this.api.isUserResolvableError(code);
 	}
 
+	@Kroll.method
+	public void makeGooglePlayServicesAvailable(final KrollFunction callback)
+	{
+		// Validate argument.
+		if (callback == null) {
+			throw new IllegalArgumentException(
+				"makeGooglePlayServicesAvailable() method must be given a 'callback' argument.");
+		}
+
+		// Do not continue if Play Services is installed and up-to-date. (This is an optimization.)
+		int resultCode = isGooglePlayServicesAvailable();
+		if (resultCode == ConnectionResult.SUCCESS) {
+			callback.callAsync(getKrollObject(), createEventForMakeAvailable(resultCode));
+			return;
+		}
+
+		// Fetch the top-most activity.
+		Activity activity = TiApplication.getAppCurrentActivity();
+		if (activity == null) {
+			activity = TiApplication.getInstance().getRootActivity();
+			if (activity == null) {
+				callback.callAsync(getKrollObject(), createEventForMakeAvailable(resultCode));
+				return;
+			}
+		}
+
+		// Display Google's standard dialog asking end-user to update Google Play Services.
+		Task<Void> task = this.api.makeGooglePlayServicesAvailable(activity);
+		task.addOnCompleteListener((Task<Void> theTask) -> {
+			int newResultCode = theTask.isSuccessful() ? ConnectionResult.SUCCESS : resultCode;
+			callback.callAsync(getKrollObject(), createEventForMakeAvailable(newResultCode));
+		});
+	}
+
+	private KrollDict createEventForMakeAvailable(int resultCode)
+	{
+		String message;
+		if (resultCode == ConnectionResult.SUCCESS) {
+			message = "Google Play Services is available. (version: " + GOOGLE_PLAY_SERVICES_VERSION_CODE + ")";
+		} else {
+			message = "Google Play Services is unavailable. (" + getErrorString(resultCode) + ")";
+		}
+
+		KrollDict event = new KrollDict();
+		event.putCodeAndMessage(resultCode, message);
+		event.put(TiC.PROPERTY_MESSAGE, message);
+		return event;
+	}
+
 	@Kroll.method
 	public String getErrorString(int code)
 	{

android/timodule.xml

@@ -2,7 +2,6 @@
 <ti:module xmlns:ti="http://ti.appcelerator.org" xmlns:android="http://schemas.android.com/apk/res/android">
 	<android xmlns:android="http://schemas.android.com/apk/res/android">
       <manifest>
-         <uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/>
          <application>
             <meta-data android:name="com.google.android.gms.version"
                        android:value="@integer/google_play_services_version"/>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@titanium-sdk/ti.playservices",
-  "version": "17.1.1",
+  "version": "17.5.0",
   "description": "Titanium Google Play Services module.",
   "scripts": {
     "ci": "node updater/index.js ci",