feat: integrate location module into sample apps

Shahroz16 · claude · Shahroz16 · commit 918e31793d2d · 2026-02-18T20:04:04.000+05:00
Register ModuleLocation in both sample apps. Add location testing UI
to the Java sample app: request location permission, set manual
location, and request one-shot SDK-managed location.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/samples/java_layout/src/main/java/io/customer/android/sample/java_layout/sdk/CustomerIORepository.java b/samples/java_layout/src/main/java/io/customer/android/sample/java_layout/sdk/CustomerIORepository.java
@@ -13,6 +13,7 @@
 import io.customer.android.sample.java_layout.support.Optional;
 import io.customer.messaginginapp.MessagingInAppModuleConfig;
 import io.customer.messaginginapp.ModuleMessagingInApp;
+import io.customer.location.ModuleLocation;
 import io.customer.messagingpush.ModuleMessagingPushFCM;
 import io.customer.sdk.CustomerIO;
 import io.customer.sdk.CustomerIOConfig;
@@ -38,6 +39,9 @@ public void initializeSdk(SampleApplication application) {
         // Enables push notification
         builder.addCustomerIOModule(new ModuleMessagingPushFCM());
 
+        // Enables location tracking
+        builder.addCustomerIOModule(new ModuleLocation());
+
         // Enables in-app messages
         if (sdkConfig.isInAppMessagingEnabled()) {
             builder.addCustomerIOModule(new ModuleMessagingInApp(
diff --git a/samples/java_layout/src/main/java/io/customer/android/sample/java_layout/ui/dashboard/DashboardActivity.java b/samples/java_layout/src/main/java/io/customer/android/sample/java_layout/ui/dashboard/DashboardActivity.java
@@ -40,6 +40,7 @@
 import io.customer.android.sample.java_layout.ui.user.AuthViewModel;
 import io.customer.android.sample.java_layout.utils.Randoms;
 import io.customer.android.sample.java_layout.utils.ViewUtils;
+import io.customer.location.ModuleLocation;
 import io.customer.sdk.CustomerIO;
 
 public class DashboardActivity extends BaseActivity<ActivityDashboardBinding> {
@@ -63,6 +64,17 @@ public class DashboardActivity extends BaseActivity<ActivityDashboardBinding> {
                 }
             });
 
+    private final ActivityResultLauncher<String[]> locationPermissionRequestLauncher =
+            registerForActivityResult(new ActivityResultContracts.RequestMultiplePermissions(), permissions -> {
+                boolean fineGranted = Boolean.TRUE.equals(permissions.get(Manifest.permission.ACCESS_FINE_LOCATION));
+                boolean coarseGranted = Boolean.TRUE.equals(permissions.get(Manifest.permission.ACCESS_COARSE_LOCATION));
+                if (fineGranted || coarseGranted) {
+                    showSnackbar(R.string.location_permission_success);
+                } else {
+                    showLocationPermissionDeniedAlert();
+                }
+            });
+
     @Override
     protected ActivityDashboardBinding inflateViewBinding() {
         return ActivityDashboardBinding.inflate(getLayoutInflater());
@@ -149,6 +161,17 @@ private void setupViews() {
         binding.showPushPromptButton.setOnClickListener(view -> {
             requestNotificationPermission();
         });
+        binding.requestLocationPermissionButton.setOnClickListener(view -> {
+            requestLocationPermission();
+        });
+        binding.setManualLocationButton.setOnClickListener(view -> {
+            ModuleLocation.instance().getLocationServices().setLastKnownLocation(37.7749, -122.4194);
+            showSnackbar(R.string.location_sent_successfully);
+        });
+        binding.requestLocationOnceButton.setOnClickListener(view -> {
+            ModuleLocation.instance().getLocationServices().requestLocationUpdate();
+            showSnackbar(R.string.location_request_sent);
+        });
         binding.inlineExamplesButton.setOnClickListener(view -> {
             startInlineExamplesActivity();
         });
@@ -262,6 +285,39 @@ private void showPushPermissionDeniedAlert(@StringRes int messageResId) {
         builder.show();
     }
 
+    private void requestLocationPermission() {
+        if (isLocationPermissionGranted()) {
+            showSnackbar(R.string.location_permission_already_granted);
+        } else {
+            locationPermissionRequestLauncher.launch(new String[]{
+                    Manifest.permission.ACCESS_FINE_LOCATION,
+                    Manifest.permission.ACCESS_COARSE_LOCATION
+            });
+        }
+    }
+
+    private boolean isLocationPermissionGranted() {
+        return ContextCompat.checkSelfPermission(this,
+                Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
+                || ContextCompat.checkSelfPermission(this,
+                Manifest.permission.ACCESS_COARSE_LOCATION) == PackageManager.PERMISSION_GRANTED;
+    }
+
+    private void showLocationPermissionDeniedAlert() {
+        MaterialAlertDialogBuilder builder = ViewUtils.createAlertDialog(this);
+        builder.setMessage(R.string.location_permission_failure);
+        builder.setNeutralButton(R.string.open_settings, (dialogInterface, i) -> {
+            Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+            intent.setData(Uri.parse("package:" + getPackageName()));
+            startActivity(intent);
+        });
+        builder.show();
+    }
+
+    private void showSnackbar(@StringRes int messageResId) {
+        Snackbar.make(binding.getRoot(), messageResId, Snackbar.LENGTH_SHORT).show();
+    }
+
     private void copyToClipboard(String text) {
         if (text.isEmpty()) {
             return;
diff --git a/samples/java_layout/src/main/res/layout/activity_dashboard.xml b/samples/java_layout/src/main/res/layout/activity_dashboard.xml
@@ -179,12 +179,51 @@
                 android:layout_height="wrap_content"
                 android:layout_marginTop="@dimen/margin_default"
                 android:text="@string/show_push_prompt"
-                app:layout_constraintBottom_toTopOf="@id/view_logs_button"
+                app:layout_constraintBottom_toTopOf="@id/request_location_permission_button"
                 app:layout_constraintEnd_toEndOf="parent"
                 app:layout_constraintStart_toStartOf="parent"
                 app:layout_constraintTop_toBottomOf="@id/set_profile_attributes_button"
                 app:layout_constraintWidth_max="@dimen/material_button_max_width" />
 
+            <Button
+                android:id="@+id/request_location_permission_button"
+                style="?attr/materialButtonStyle"
+                android:layout_width="0dp"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="@dimen/margin_default"
+                android:text="@string/request_location_permission"
+                app:layout_constraintBottom_toTopOf="@id/set_manual_location_button"
+                app:layout_constraintEnd_toEndOf="parent"
+                app:layout_constraintStart_toStartOf="parent"
+                app:layout_constraintTop_toBottomOf="@id/show_push_prompt_button"
+                app:layout_constraintWidth_max="@dimen/material_button_max_width" />
+
+            <Button
+                android:id="@+id/set_manual_location_button"
+                style="?attr/materialButtonStyle"
+                android:layout_width="0dp"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="@dimen/margin_default"
+                android:text="@string/set_manual_location"
+                app:layout_constraintBottom_toTopOf="@id/request_location_once_button"
+                app:layout_constraintEnd_toEndOf="parent"
+                app:layout_constraintStart_toStartOf="parent"
+                app:layout_constraintTop_toBottomOf="@id/request_location_permission_button"
+                app:layout_constraintWidth_max="@dimen/material_button_max_width" />
+
+            <Button
+                android:id="@+id/request_location_once_button"
+                style="?attr/materialButtonStyle"
+                android:layout_width="0dp"
+                android:layout_height="wrap_content"
+                android:layout_marginTop="@dimen/margin_default"
+                android:text="@string/request_location_once"
+                app:layout_constraintBottom_toTopOf="@id/view_logs_button"
+                app:layout_constraintEnd_toEndOf="parent"
+                app:layout_constraintStart_toStartOf="parent"
+                app:layout_constraintTop_toBottomOf="@id/set_manual_location_button"
+                app:layout_constraintWidth_max="@dimen/material_button_max_width" />
+
             <Button
                 android:id="@+id/view_logs_button"
                 style="?attr/materialButtonStyle"
diff --git a/samples/java_layout/src/main/res/values/strings.xml b/samples/java_layout/src/main/res/values/strings.xml
@@ -93,4 +93,14 @@
     <string name="title_inline_recycler">RecyclerView</string>
     <string name="inline_examples_tabbed">Inline Examples</string>
 
+    <!-- Location -->
+    <string name="request_location_permission">Request Location Permission</string>
+    <string name="set_manual_location">Set Manual Location</string>
+    <string name="request_location_once">Request Location Once</string>
+    <string name="location_permission_success">Location permission granted</string>
+    <string name="location_permission_failure">Location permission denied. Please allow location permission from settings.</string>
+    <string name="location_permission_already_granted">Location permission already granted</string>
+    <string name="location_sent_successfully">Manual location sent successfully</string>
+    <string name="location_request_sent">Location request sent</string>
+
 </resources>
diff --git a/samples/kotlin_compose/src/main/java/io/customer/android/sample/kotlin_compose/MainApplication.kt b/samples/kotlin_compose/src/main/java/io/customer/android/sample/kotlin_compose/MainApplication.kt
@@ -4,6 +4,7 @@ import android.app.Application
 import io.customer.android.sample.kotlin_compose.data.models.setValuesFromBuilder
 import io.customer.android.sample.kotlin_compose.data.sdk.InAppMessageEventListener
 import io.customer.android.sample.kotlin_compose.di.ServiceLocator
+import io.customer.location.ModuleLocation
 import io.customer.messaginginapp.MessagingInAppModuleConfig
 import io.customer.messaginginapp.ModuleMessagingInApp
 import io.customer.messagingpush.ModuleMessagingPushFCM
@@ -37,6 +38,7 @@ class MainApplication : Application() {
                 )
             )
             .addCustomerIOModule(ModuleMessagingPushFCM())
+            .addCustomerIOModule(ModuleLocation())
         configuration.setValuesFromBuilder(builder)
 
         CustomerIO.initialize(builder.build())
diff --git a/samples/sample-app.gradle b/samples/sample-app.gradle
@@ -128,13 +128,15 @@ dependencies {
         implementation(project(":messaginginapp"))
         // messaginginapp-compose adds messaginginapp transitively
         implementation(project(":messaginginapp-compose"))
+        implementation(project(":location"))
     } else {
         // Stable releases dependency, use published versions directly
         implementation "io.customer.android:datapipelines:$cioSDKVersion"
         implementation "io.customer.android:messaging-push-fcm:$cioSDKVersion"
         implementation "io.customer.android:messaging-in-app:$cioSDKVersion"
         // messaginginapp-compose adds messaginginapp transitively
         implementation "io.customer.android:messaging-in-app-compose:$cioSDKVersion"
+        implementation "io.customer.android:location:$cioSDKVersion"
     }
     
     // Add Compose dependencies for all sample projects

Original file line number	Diff line number	Diff line change
`@@ -4,6 +4,7 @@ import android.app.Application`
`4`	`4`	`import io.customer.android.sample.kotlin_compose.data.models.setValuesFromBuilder`
`5`	`5`	`import io.customer.android.sample.kotlin_compose.data.sdk.InAppMessageEventListener`
`6`	`6`	`import io.customer.android.sample.kotlin_compose.di.ServiceLocator`
	`7`	`+import io.customer.location.ModuleLocation`
`7`	`8`	`import io.customer.messaginginapp.MessagingInAppModuleConfig`
`8`	`9`	`import io.customer.messaginginapp.ModuleMessagingInApp`
`9`	`10`	`import io.customer.messagingpush.ModuleMessagingPushFCM`
`@@ -37,6 +38,7 @@ class MainApplication : Application() {`
`37`	`38`	`)`
`38`	`39`	`)`
`39`	`40`	`.addCustomerIOModule(ModuleMessagingPushFCM())`
	`41`	`+ .addCustomerIOModule(ModuleLocation())`
`40`	`42`	`configuration.setValuesFromBuilder(builder)`
`41`	`43`
`42`	`44`	`CustomerIO.initialize(builder.build())`