Add Settings option to denied location prompt

   * Whenever the user clicks on never ask again option and denies the permission,
     we will show the reason why we need it and the option to open settings and change the location permission
   * Don't show setting dialog after first never ask again option click

Author: Jeasmine

OneSignalSDK/onesignal/src/main/java/com/onesignal/AndroidSupportV4Compat.java

@@ -35,6 +35,7 @@
 import android.content.pm.PackageManager;
 import android.os.Build;
 import android.support.annotation.NonNull;
+import android.support.v4.app.ActivityCompat;
 import android.util.Log;
 
 // Designed as a compat for use of Android Support v4 revision 23.+ methods when an older revision of the library is included with the app developer's project.
@@ -68,6 +69,10 @@ static void requestPermissions(final @NonNull Activity activity, final @NonNull
          // OneSignal SDK code already checks that device is Android M, omit else code from the support library.
          ActivityCompatApi23.requestPermissions(activity, permissions, requestCode);
       }
+
+      static boolean shouldShowRequestPermissionRationale(Activity activity, String permission) {
+         return ActivityCompatApi23.shouldShowRequestPermissionRationale(activity, permission);
+      }
    }
 
    @TargetApi(23)
@@ -77,5 +82,9 @@ static void requestPermissions(Activity activity, String[] permissions, int requ
             ((RequestPermissionsRequestCodeValidator) activity).validateRequestPermissionsRequestCode(requestCode);
          activity.requestPermissions(permissions, requestCode);
       }
+
+      static boolean shouldShowRequestPermissionRationale(Activity activity, String permission) {
+         return android.support.v4.app.ActivityCompat.shouldShowRequestPermissionRationale(activity, permission);
+      }
    }
 }

OneSignalSDK/onesignal/src/main/java/com/onesignal/LocationGMS.java

@@ -167,7 +167,7 @@ static void sendAndClearPromptHandlers(boolean promptLocation, OneSignal.PromptA
     *
     *  For all cases we are calling prompt listeners.
     */
-   static void getLocation(Context context, boolean promptLocation, LocationHandler handler) {
+   static void getLocation(Context context, boolean promptLocation, boolean fallbackToSettings, LocationHandler handler) {
       addPromptHandlerIfAvailable(handler);
       classContext = context;
       locationHandlers.put(handler.getType(), handler);
@@ -226,7 +226,7 @@ else if (permissionList.contains("android.permission.ACCESS_COARSE_LOCATION")) {
                //
                // For each case, we call the prompt handlers
                if (requestPermission != null && promptLocation) {
-                  PermissionsActivity.startPrompt();
+                  PermissionsActivity.startPrompt(fallbackToSettings);
                } else if (locationCoarsePermission == PackageManager.PERMISSION_GRANTED) {
                   sendAndClearPromptHandlers(promptLocation, OneSignal.PromptActionResult.PERMISSION_GRANTED);
                   startGetLocation();

OneSignalSDK/onesignal/src/main/java/com/onesignal/OSInAppMessageLocationPrompt.java

@@ -6,7 +6,7 @@ class OSInAppMessageLocationPrompt extends OSInAppMessagePrompt {
 
     @Override
     void handlePrompt(OneSignal.OSPromptActionCompletionCallback callback) {
-        OneSignal.promptLocation(callback);
+        OneSignal.promptLocation(callback, true);
     }
 
     @Override

OneSignalSDK/onesignal/src/main/java/com/onesignal/OneSignal.java

@@ -947,7 +947,7 @@ public void onComplete(LocationGMS.LocationPoint point) {
       // Prompted so we don't ask for permissions more than once
       promptedLocation = promptedLocation || mInitBuilder.mPromptLocation;
 
-      LocationGMS.getLocation(appContext, doPrompt, locationHandler);
+      LocationGMS.getLocation(appContext, doPrompt, false, locationHandler);
    }
    private static PushRegistrator mPushRegistrator;
 
@@ -2524,10 +2524,10 @@ public static void setLocationShared(boolean enable) {
     * @see <a href="https://documentation.onesignal.com/docs/permission-requests">Permission Requests | OneSignal Docs</a>
     */
    public static void promptLocation() {
-      promptLocation(null);
+      promptLocation(null, false);
    }
 
-   static void promptLocation(@Nullable final OSPromptActionCompletionCallback callback) {
+   static void promptLocation(@Nullable final OSPromptActionCompletionCallback callback, final boolean fallbackToSettings) {
       //if applicable, check if the user provided privacy consent
       if (shouldLogUserPrivacyConsentErrorMessageForMethodName("promptLocation()"))
          return;
@@ -2558,7 +2558,7 @@ void onAnswered(OneSignal.PromptActionResult result) {
                }
             };
 
-            LocationGMS.getLocation(appContext, true, locationHandler);
+            LocationGMS.getLocation(appContext, true, fallbackToSettings, locationHandler);
             promptedLocation = true;
          }
       };

OneSignalSDK/onesignal/src/main/java/com/onesignal/OneSignalSyncServiceUtils.java

@@ -230,7 +230,7 @@ public void onComplete(LocationGMS.LocationPoint point) {
                   queue.offer(object);
                }
             };
-            LocationGMS.getLocation(OneSignal.appContext, false, locationHandler);
+            LocationGMS.getLocation(OneSignal.appContext, false, false, locationHandler);
 
             // The take() will return the offered point once the callback for the locationHandler is completed
             Object point = queue.take();

OneSignalSDK/onesignal/src/main/java/com/onesignal/PermissionsActivity.java

@@ -28,8 +28,11 @@
 package com.onesignal;
 
 import android.app.Activity;
+import android.app.AlertDialog;
+import android.content.DialogInterface;
 import android.content.Intent;
 import android.content.pm.PackageManager;
+import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
 import android.os.Handler;
@@ -44,10 +47,11 @@ public class PermissionsActivity extends Activity {
    // Default animation duration in milliseconds
    private static final int DELAY_TIME_CALLBACK_CALL = 500;
    private static final int REQUEST_LOCATION = 2;
+   private static final int REQUEST_SETTINGS = 3;
 
-   static boolean waiting, answered;
+   static boolean waiting, answered, fallbackToSettings, neverAskAgainClicked;
    private static ActivityLifecycleHandler.ActivityAvailableListener activityAvailableListener;
-   
+
    @Override
    protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
@@ -83,6 +87,7 @@ private void requestPermission() {
 
       if (!waiting) {
          waiting = true;
+         neverAskAgainClicked = !ActivityCompat.shouldShowRequestPermissionRationale(PermissionsActivity.this, LocationGMS.requestPermission);
          ActivityCompat.requestPermissions(this, new String[]{LocationGMS.requestPermission}, REQUEST_LOCATION);
       }
    }
@@ -105,10 +110,12 @@ public void run() {
                boolean granted = grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED;
                OneSignal.PromptActionResult result = granted ? OneSignal.PromptActionResult.PERMISSION_GRANTED : OneSignal.PromptActionResult.PERMISSION_DENIED;
                LocationGMS.sendAndClearPromptHandlers(true, result);
-               if (granted)
+               if (granted) {
                   LocationGMS.startGetLocation();
-               else
+               } else {
+                  attemptToShowLocationPermissionSettings();
                   LocationGMS.fireFailedComplete();
+               }
             }
          }, DELAY_TIME_CALLBACK_CALL);
       }
@@ -117,11 +124,39 @@ public void run() {
       overridePendingTransition(R.anim.onesignal_fade_in, R.anim.onesignal_fade_out);
    }
 
+   private void attemptToShowLocationPermissionSettings() {
+      if (fallbackToSettings
+              && neverAskAgainClicked
+              && !ActivityCompat.shouldShowRequestPermissionRationale(PermissionsActivity.this, LocationGMS.requestPermission))
+         showLocationPermissionSettings();
+   }
+
+   private void showLocationPermissionSettings() {
+      new AlertDialog.Builder(ActivityLifecycleHandler.curActivity)
+              .setTitle(R.string.location_not_available_title)
+              .setMessage(R.string.location_not_available_open_settings_message)
+              .setPositiveButton(R.string.location_not_available_open_settings_option, new DialogInterface.OnClickListener() {
+                 public void onClick(DialogInterface dialog, int which) {
+                    Intent intent = new Intent(android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+                    intent.setData(Uri.parse("package:" + getPackageName()));
+                    startActivity(intent);
+                    LocationGMS.sendAndClearPromptHandlers(true, OneSignal.PromptActionResult.PERMISSION_DENIED);
+                 }
+              })
+              .setNegativeButton(android.R.string.no, new DialogInterface.OnClickListener() {
+                 @Override
+                 public void onClick(DialogInterface dialog, int which) {
+                    LocationGMS.sendAndClearPromptHandlers(true, OneSignal.PromptActionResult.PERMISSION_DENIED);
+                 }
+              })
+              .show();
+   }
 
-   static void startPrompt() {
+   static void startPrompt(boolean fallbackCondition) {
       if (PermissionsActivity.waiting || PermissionsActivity.answered)
          return;
 
+      fallbackToSettings = fallbackCondition;
       activityAvailableListener = new ActivityLifecycleHandler.ActivityAvailableListener() {
          @Override
          public void available(@NonNull Activity activity) {

OneSignalSDK/onesignal/src/main/res/values/strings.xml

@@ -4,4 +4,6 @@
     <string name="location_not_available_title">Location Not Available</string>
     <string name="location_not_available_message">Looks like this app doesn\'t have location services configured. Please see OneSignal docs for more information.</string>
 
+    <string name="location_not_available_open_settings_message">You have previously denied sharing your device location. Please go to settings to enable.</string>
+    <string name="location_not_available_open_settings_option">Settings</string>
 </resources>