diff --git a/samples/add-elevation-source-from-tile-package/src/main/java/com/esri/arcgismaps/sample/addelevationsourcefromtilepackage/DownloadActivity.kt b/samples/add-elevation-source-from-tile-package/src/main/java/com/esri/arcgismaps/sample/addelevationsourcefromtilepackage/DownloadActivity.kt index da9c878bd..9c65ab3d8 100644 --- a/samples/add-elevation-source-from-tile-package/src/main/java/com/esri/arcgismaps/sample/addelevationsourcefromtilepackage/DownloadActivity.kt +++ b/samples/add-elevation-source-from-tile-package/src/main/java/com/esri/arcgismaps/sample/addelevationsourcefromtilepackage/DownloadActivity.kt @@ -1,3 +1,19 @@ +/* Copyright 2025 Esri + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + package com.esri.arcgismaps.sample.addelevationsourcefromtilepackage import android.content.Intent diff --git a/samples/apply-dictionary-renderer-to-graphics-overlay/src/main/java/com/esri/arcgismaps/sample/applydictionaryrenderertographicsoverlay/DownloadActivity.kt b/samples/apply-dictionary-renderer-to-graphics-overlay/src/main/java/com/esri/arcgismaps/sample/applydictionaryrenderertographicsoverlay/DownloadActivity.kt index a61b5b30e..6dfa4c886 100644 --- a/samples/apply-dictionary-renderer-to-graphics-overlay/src/main/java/com/esri/arcgismaps/sample/applydictionaryrenderertographicsoverlay/DownloadActivity.kt +++ b/samples/apply-dictionary-renderer-to-graphics-overlay/src/main/java/com/esri/arcgismaps/sample/applydictionaryrenderertographicsoverlay/DownloadActivity.kt @@ -1,3 +1,19 @@ +/* Copyright 2025 Esri + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + package com.esri.arcgismaps.sample.applydictionaryrenderertographicsoverlay import android.content.Intent diff --git a/samples/show-mobile-map-package-expiration-date/README.md b/samples/show-mobile-map-package-expiration-date/README.md new file mode 100644 index 000000000..453eefbdf --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/README.md @@ -0,0 +1,37 @@ +# Show mobile map package expiration date + +Access the expiration information of an expired mobile map package. + +![Image of Show mobile map package expiration date](show-mobile-map-package-expiration-date.png) + +## Use case + +The data contained within a mobile map package (MMPK) may only be relevant for a fixed period of time. Using ArcGIS Pro, the author of an MMPK can set an expiration date to ensure the user is aware the data is out of date. + +As long as the author of an MMPK has set an expiration date, the expiration date can be read even if the MMPK has not yet expired. For example, developers could also use this API to warn app users that an MMPK may be expiring soon. + +## How to use the sample + +Launch the app. The author of the MMPK used in this sample chose to set the MMPK's map as still readable, even if it's expired. The app presents expiration information to the user. + +## How it works + +1. Create a `MobileMapPackage` object by providing a path to the local mobile map package file. +2. Load the `MobileMapPackage`. +3. Present the mobile map package's expiration information to the user: + * Use `Expiration.message` to get the expiration message set by the author of the MMPK. + * Use `Expiration.dateTime` to get the expiration date set by the author of the MMPK. + * Use `Expiration.isExpired` to determine whether the MMPK has expired. + +## Relevant API + +* Expiration +* MobileMapPackage + +## Offline data + +This sample uses the [LothianRiversAnno - Expired](https://www.arcgis.com/home/item.html?id=174150279af74a2ba6f8b87a567f480b) mobile map package. It is downloaded from ArcGIS Online automatically. + +## Tags + +expiration, mmpk diff --git a/samples/show-mobile-map-package-expiration-date/README.metadata.json b/samples/show-mobile-map-package-expiration-date/README.metadata.json new file mode 100644 index 000000000..185cea04a --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/README.metadata.json @@ -0,0 +1,32 @@ +{ + "category": "Maps", + "description": "Access the expiration information of an expired mobile map package.", + "formal_name": "ShowMobileMapPackageExpirationDate", + "ignore": false, + "images": [ + "show-mobile-map-package-expiration-date.png" + ], + "keywords": [ + "expiration", + "mmpk", + "Expiration", + "MobileMapPackage" + ], + "language": "kotlin", + "provision_from": [ + "https://www.arcgis.com/home/item.html?id=174150279af74a2ba6f8b87a567f480b" + ], + "provision_to": [], + "redirect_from": "", + "relevant_apis": [ + "Expiration", + "MobileMapPackage" + ], + "snippets": [ + "src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/components/ShowMobileMapPackageExpirationDateViewModel.kt", + "src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/MainActivity.kt", + "src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/DownloadActivity.kt", + "src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/screens/ShowMobileMapPackageExpirationDateScreen.kt" + ], + "title": "Show mobile map package expiration date" +} diff --git a/samples/show-mobile-map-package-expiration-date/build.gradle.kts b/samples/show-mobile-map-package-expiration-date/build.gradle.kts new file mode 100644 index 000000000..9ba27de0d --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/build.gradle.kts @@ -0,0 +1,22 @@ +plugins { + alias(libs.plugins.arcgismaps.android.library) + alias(libs.plugins.arcgismaps.android.library.compose) + alias(libs.plugins.arcgismaps.kotlin.sample) + alias(libs.plugins.gradle.secrets) +} + +secrets { + // this file doesn't contain secrets, it just provides defaults which can be committed into git. + defaultPropertiesFileName = "secrets.defaults.properties" +} + +android { + namespace = "com.esri.arcgismaps.sample.showmobilemappackageexpirationdate" + buildFeatures { + buildConfig = true + } +} + +dependencies { + // Only module specific dependencies needed here +} diff --git a/samples/show-mobile-map-package-expiration-date/show-mobile-map-package-expiration-date.png b/samples/show-mobile-map-package-expiration-date/show-mobile-map-package-expiration-date.png new file mode 100644 index 000000000..d9cb6d05f Binary files /dev/null and b/samples/show-mobile-map-package-expiration-date/show-mobile-map-package-expiration-date.png differ diff --git a/samples/show-mobile-map-package-expiration-date/src/main/AndroidManifest.xml b/samples/show-mobile-map-package-expiration-date/src/main/AndroidManifest.xml new file mode 100644 index 000000000..dc0a9abf5 --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/src/main/AndroidManifest.xml @@ -0,0 +1,18 @@ + + + + + + + + + + + + diff --git a/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/DownloadActivity.kt b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/DownloadActivity.kt new file mode 100644 index 000000000..0d47bd667 --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/DownloadActivity.kt @@ -0,0 +1,34 @@ +/* Copyright 2025 Esri + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + +package com.esri.arcgismaps.sample.showmobilemappackageexpirationdate + +import android.content.Intent +import android.os.Bundle +import com.esri.arcgismaps.sample.sampleslib.DownloaderActivity + +class DownloadActivity : DownloaderActivity() { + override fun onCreate(savedInstanceState: Bundle?) { + super.onCreate(savedInstanceState) + downloadAndStartSample( + Intent(this, MainActivity::class.java), + getString(R.string.show_mobile_map_package_expiration_date_app_name), + listOf( + "https://www.arcgis.com/home/item.html?id=174150279af74a2ba6f8b87a567f480b" + ) + ) + } +} \ No newline at end of file diff --git a/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/MainActivity.kt b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/MainActivity.kt new file mode 100644 index 000000000..b5cbce56e --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/MainActivity.kt @@ -0,0 +1,53 @@ +/* Copyright 2025 Esri + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + +package com.esri.arcgismaps.sample.showmobilemappackageexpirationdate + +import android.os.Bundle +import androidx.activity.ComponentActivity +import androidx.activity.compose.setContent +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Surface +import androidx.compose.runtime.Composable +import com.arcgismaps.ApiKey +import com.arcgismaps.ArcGISEnvironment +import com.esri.arcgismaps.sample.sampleslib.theme.SampleAppTheme +import com.esri.arcgismaps.sample.showmobilemappackageexpirationdate.screens.ShowMobileMapPackageExpirationDateScreen + +class MainActivity : ComponentActivity() { + + override fun onCreate(savedInstanceState: Bundle?) { + super.onCreate(savedInstanceState) + // authentication with an API key or named user is + // required to access basemaps and other location services + ArcGISEnvironment.apiKey = ApiKey.create(BuildConfig.ACCESS_TOKEN) + + setContent { + SampleAppTheme { + ShowMobileMapPackageExpirationDateApp() + } + } + } + + @Composable + private fun ShowMobileMapPackageExpirationDateApp() { + Surface(color = MaterialTheme.colorScheme.background) { + ShowMobileMapPackageExpirationDateScreen( + sampleName = getString(R.string.show_mobile_map_package_expiration_date_app_name) + ) + } + } +} diff --git a/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/components/ShowMobileMapPackageExpirationDateViewModel.kt b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/components/ShowMobileMapPackageExpirationDateViewModel.kt new file mode 100644 index 000000000..c390b1016 --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/components/ShowMobileMapPackageExpirationDateViewModel.kt @@ -0,0 +1,109 @@ +/* Copyright 2025 Esri + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + +package com.esri.arcgismaps.sample.showmobilemappackageexpirationdate.components + +import android.app.Application +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.setValue +import androidx.lifecycle.AndroidViewModel +import androidx.lifecycle.viewModelScope +import com.arcgismaps.mapping.ArcGISMap +import com.arcgismaps.mapping.MobileMapPackage +import com.esri.arcgismaps.sample.sampleslib.components.MessageDialogViewModel +import com.esri.arcgismaps.sample.showmobilemappackageexpirationdate.R +import java.io.File +import java.time.ZoneId +import java.time.format.DateTimeFormatter +import java.time.format.FormatStyle +import java.util.Locale +import kotlinx.coroutines.launch + +class ShowMobileMapPackageExpirationDateViewModel(val app: Application) : AndroidViewModel(app) { + // The map displayed on the MapView. Updated after loading the mobile map package + var arcGISMap: ArcGISMap by mutableStateOf(ArcGISMap()) + private set + + // Message dialog view model for handling error messages + val messageDialogVM = MessageDialogViewModel() + + // Expiration UI states exposed to the screen + var isExpired by mutableStateOf(false) + private set + + var expirationMessage by mutableStateOf("") + private set + + var expirationDateText by mutableStateOf("N/A") + private set + + // Build the provision path where offline resources are stored for the sample app + private val provisionPath: String by lazy { + val basePath = app.getExternalFilesDir(null)?.path.toString() + val appFolderName = app.getString(R.string.show_mobile_map_package_expiration_date_app_name) + basePath + File.separator + appFolderName + } + + init { + // Load the mobile map package and update map/expiration info + viewModelScope.launch { + loadMobileMapPackageAndUpdateState() + } + } + + // Loads the local mobile map package and updates the map and expiration states + private suspend fun loadMobileMapPackageAndUpdateState() { + // Locate the LothianRiversAnno.mmpk file in the provisioned path + val mmpkFile = File(provisionPath, "LothianRiversAnno.mmpk") + if (!mmpkFile.exists()) { + messageDialogVM.showMessageDialog("Mobile map package file does not exist.") + return + } + + // Create and load the mobile map package + val mobileMapPackage = MobileMapPackage(mmpkFile.path) + mobileMapPackage.load().onSuccess { + // If the loaded mobile map package does not contain any maps + val map = mobileMapPackage.maps.firstOrNull() + if (map == null) { + messageDialogVM.showMessageDialog("Mobile map package does not contain a map") + return@onSuccess + } + + // Set the map to the first map in the mobile map package + arcGISMap = map + + // Read expiration information from the mobile map package + mobileMapPackage.expiration?.let { expiration -> + isExpired = expiration.isExpired + expirationMessage = expiration.message + + val formatter = DateTimeFormatter + .ofLocalizedDateTime(FormatStyle.SHORT) + .withLocale(Locale.getDefault()) + .withZone(ZoneId.systemDefault()) + + expirationDateText = expiration.dateTime?.let { formatter.format(it) } ?: "N/A" + } + }.onFailure { error -> + messageDialogVM.showMessageDialog( + title = "Failed to load the mobile map package", + description = error.message.toString() + ) + } + } +} diff --git a/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/screens/ShowMobileMapPackageExpirationDateScreen.kt b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/screens/ShowMobileMapPackageExpirationDateScreen.kt new file mode 100644 index 000000000..244e030bf --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/src/main/java/com/esri/arcgismaps/sample/showmobilemappackageexpirationdate/screens/ShowMobileMapPackageExpirationDateScreen.kt @@ -0,0 +1,101 @@ +/* Copyright 2025 Esri + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + * + */ + +package com.esri.arcgismaps.sample.showmobilemappackageexpirationdate.screens + +import androidx.compose.foundation.background +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.Card +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Scaffold +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.style.TextAlign +import androidx.compose.ui.unit.dp +import androidx.lifecycle.viewmodel.compose.viewModel +import com.arcgismaps.toolkit.geoviewcompose.MapView +import com.esri.arcgismaps.sample.sampleslib.components.MessageDialog +import com.esri.arcgismaps.sample.sampleslib.components.SampleTopAppBar +import com.esri.arcgismaps.sample.showmobilemappackageexpirationdate.components.ShowMobileMapPackageExpirationDateViewModel + +/** + * Main screen layout for the sample app which displays the map from a mobile map package + * and shows expiration information if the mobile map package has expired. + */ +@Composable +fun ShowMobileMapPackageExpirationDateScreen(sampleName: String) { + val mapViewModel: ShowMobileMapPackageExpirationDateViewModel = viewModel() + + Scaffold( + topBar = { SampleTopAppBar(title = sampleName) }, + content = { paddingValues -> + Box( + modifier = Modifier + .fillMaxSize() + .padding(paddingValues) + ) { + MapView( + modifier = Modifier.fillMaxSize(), + arcGISMap = mapViewModel.arcGISMap + ) + + // Display expiration information overlay if the mobile map package is expired + if (mapViewModel.isExpired) { + Card( + modifier = Modifier + .align(Alignment.Center) + .padding(top = 16.dp, bottom = 16.dp) + .background(MaterialTheme.colorScheme.surfaceVariant) + ) { + Column( + modifier = Modifier.padding(16.dp), + horizontalAlignment = Alignment.CenterHorizontally + ) { + Text( + text = mapViewModel.expirationMessage, + style = MaterialTheme.typography.bodyMedium, + textAlign = TextAlign.Center + ) + Spacer(modifier = Modifier.padding(8.dp)) + Text( + text = "Expiration date: ${mapViewModel.expirationDateText}", + style = MaterialTheme.typography.bodySmall, + textAlign = TextAlign.Center + ) + } + } + } + + // Display error dialog when the sample encounters an error + mapViewModel.messageDialogVM.apply { + if (dialogStatus) { + MessageDialog( + title = messageTitle, + description = messageDescription, + onDismissRequest = ::dismissDialog + ) + } + } + } + } + ) +} diff --git a/samples/show-mobile-map-package-expiration-date/src/main/res/values/strings.xml b/samples/show-mobile-map-package-expiration-date/src/main/res/values/strings.xml new file mode 100644 index 000000000..08bd1df16 --- /dev/null +++ b/samples/show-mobile-map-package-expiration-date/src/main/res/values/strings.xml @@ -0,0 +1,3 @@ + + Show mobile map package expiration date +