Merge branch 'v.next' into Caleb/New-CreateDynamicBasemapGallery

Author: CalebRas

Documentation/ConfigureAppSecrets.md

@@ -1,18 +1,18 @@
 # Configure App Secrets
 
-As a best-practice principle, the project conceals app secrets from source code by generating and compiling an `AppSecrets.swift` source code file at build time using a custom build rule.
+As a best-practice principle, our project conceals app secrets from source code by generating and compiling an `AppSecrets.swift` source code file at build time using a custom build rule. The same pattern can be applied to your app development as well.
 
 This build rule looks for a secrets file stored in the project's root directory, `$(SRCROOT)/.secrets`.
 
-Note: License keys are not required for development. Without licensing or licensing with invalid keys do not throw an exception, but simply fail to license the app, falling back to Developer Mode (which will display a watermark on the map and scene views). Apply the license keys when the app is ready for deployment.
+Note: License strings are not required for development. Without licensing or licensing with invalid keys do not throw an exception, but simply fail to license the app, falling back to Developer Mode (which will display a watermark on the map and scene views). Apply the license strings when your app is ready for deployment.
 
-1. Create a hidden secrets file in the project's root directory.
+1. Create a hidden secrets file in your project's root directory.
 
   ```sh
   touch .secrets
   ```
 
-2. Add your **License Key** to the secrets file. Licensing the app will remove the 'Licensed for Developer Use Only' watermark. Licensing the app is optional in development but required for production. Add your **Extension License Key** and **API Key** to the secrets file if needed. Acquire license keys from your [dashboard](https://developers.arcgis.com/dashboard).
+2. Add your **License String** to the secrets file. Licensing the app will remove the 'Licensed for Developer Use Only' watermark. Licensing the app is optional in development but required for production. Add your **Extension License String** and **API Key** access token to the secrets file if needed. Learn more about how to [Get a license](https://developers.arcgis.com/swift/license-and-deployment/get-a-license/).
 
   ```sh
   echo ARCGIS_LICENSE_KEY=your-license-key >> .secrets
@@ -22,6 +22,6 @@ Note: License keys are not required for development. Without licensing or licens
 
   > Replace 'your-license-key', 'your-extension-license-key' and 'your-api-key' with your keys.
 
-Visit the developer's website to learn more about [Deployment](https://developers.arcgis.com/documentation/mapping-apis-and-services/deployment/) and [Security and authentication](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/).
+Visit the developer's website to learn more about [Deployment](https://developers.arcgis.com/swift/license-and-deployment/) and [Security and authentication](https://developers.arcgis.com/documentation/security-and-authentication/).
 
 To learn more about `masquerade`, consult the [documentation](https://github.com/Esri/data-collection-ios/tree/main/docs#masquerade) of Esri's Data Collection app.

README.md

@@ -1,6 +1,6 @@
-# ArcGIS Maps SDK for Swift Samples
+# ArcGIS Maps SDK for Swift Samples [![](https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg)](https://apps.apple.com/us/app/arcgis-maps-swift-samples/id1630449018)
 
-This repository contains Swift sample code demonstrating the capabilities of the [ArcGIS Maps SDK for Swift](https://developers.arcgis.com/swift/) and how to use those capabilities in your own app. The project can be opened in Xcode and run on a simulator or a device.
+This repository contains Swift sample code demonstrating the capabilities of the [ArcGIS Maps SDK for Swift](https://developers.arcgis.com/swift/) and how to use those capabilities in your own app. The project can be opened in Xcode and run on a simulator or a device.  Or you can [download the app from the App Store](https://apps.apple.com/us/app/arcgis-maps-swift-samples/id1630449018) on your iOS device.
 
 ## Features
 
@@ -36,25 +36,29 @@ The *ArcGIS Maps SDK for Swift Samples app* has a *Target SDK* version of *16.0*
 ## Configuring API Keys
 
 > [!IMPORTANT]
-> Acquire the keys from your [dashboard](https://developers.arcgis.com/dashboard). Visit the developer's website to learn more about [API keys](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/api-keys/).
+> To run this app and access ArcGIS Location Services, follow these steps to obtain an **API key** access token and store it in a secrets file stored in the project file's directory, `$(SRCROOT)/.secrets`.
 
-To run this app and access specific, ready-to-use services such as basemap layer, follow the steps to add an API key to a secrets file stored in the project file's directory, `$(SRCROOT)/.secrets`.
+1. Go to the [Create an API key](https://developers.arcgis.com/documentation/security-and-authentication/api-key-authentication/tutorials/create-an-api-key/) tutorial to obtain the API key access token. Ensure that the following privileges are enabled:
 
-1. Create a hidden secrets file in the project file's directory.
+* Location services > Basemaps
+* Location services > Geocoding
+* Location services > Routing
+
+2. Create a hidden secrets file in the project file's directory.
 
   ```sh
   touch .secrets
   ```
 
-2. Add your **API Key** to the aforementioned secrets file. Adding an API key allows you to access a set of ready-to-use services, including basemaps.
+3. Add your API key to the aforementioned secrets file. Adding an API key allows you to access ArcGIS location services, such as the basemap styles service.
 
   ```sh
   echo ARCGIS_API_KEY_IOS=your-api-key >> .secrets
   ```
 
-  > Replace 'your-api-key' with your keys.
+  > Replace 'your-api-key' with your API Key access token.
 
-Please see [Configure App Secrets](Documentation/ConfigureAppSecrets.md) for adding license key and other details.
+Please see [Configure App Secrets](Documentation/ConfigureAppSecrets.md) for adding license string and other details.
 
 ## Additional Resources