Merge pull request #666 from Esri/v.next

[Release] 200.8.0

Author: CalebRas

README.md

@@ -4,12 +4,12 @@ This repository contains Swift sample code demonstrating the capabilities of the
 
 ## Features
 
-* Maps - Open, create, interact with and save maps
+* Maps - Open, create, interact with, and save maps
 * Scenes - Visualize 3D environments and symbols
 * Layers - Display vector and raster data in maps and scenes
 * Augmented Reality - View data overlaid on the real world through your device's camera
 * Visualization - Show graphics, popups, callouts, sketches, and style maps with symbols and renderers
-* Edit and Manage Data - Add, delete, and edit features and attachments, and taking data offline
+* Edit and Manage Data - Add, delete, and edit features and attachments, and take data offline
 * Search and Query - Find addresses, places, and points of interest
 * Routing and Logistics - Calculate routes between locations and around barriers
 * Analysis - Perform spatial analysis via geoprocessing tasks and services
@@ -18,11 +18,11 @@ This repository contains Swift sample code demonstrating the capabilities of the
 
 ## Requirements
 
-* [ArcGIS Maps SDK for Swift](https://developers.arcgis.com/swift/) 200.7 (or newer)
-* [ArcGIS Maps SDK for Swift Toolkit](https://github.com/Esri/arcgis-maps-sdk-swift-toolkit) 200.7 (or newer)
-* Xcode 16.0 (or newer)
+* [ArcGIS Maps SDK for Swift](https://developers.arcgis.com/swift/) 200.8 (or newer)
+* [ArcGIS Maps SDK for Swift Toolkit](https://github.com/Esri/arcgis-maps-sdk-swift-toolkit) 200.8 (or newer)
+* Xcode 16.4 (or newer)
 
-The *ArcGIS Maps SDK for Swift Samples app* has a *Target SDK* version of *16.0*, meaning that it can run on devices with *iOS 16.0* or newer.
+The *ArcGIS Maps SDK for Swift Samples app* has a *Target SDK* version of *17.0*, meaning that it can run on devices with *iOS 17.0* or newer.
 
 ## Building Samples Using Swift Package Manager
 
@@ -75,7 +75,7 @@ Find a bug or want to request a new feature? Please let us know by [creating an
 
 ## Licensing
 
-Copyright 2022 - 2024 Esri
+Copyright 2022 - 2025 Esri
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

Samples.xcodeproj/project.pbxproj

@@ -26,6 +26,7 @@
     'Arcade',
     'ArcGIS Online',
     'ArcGIS Pro',
+    'Authenticate with Integrated Windows Authentication',
     'GeoPackage',
     'OAuth',
     'OpenStreetMap',
@@ -274,6 +275,7 @@ def __init__(self, folder_path: str):
 
         # A list of ArcGIS Portal Item IDs.
         self.offline_data = []      # Default to empty list.
+        self.has_teardown = False   # Only applies to samples that require async tear down (e.g., authentication).
 
         self.folder_path = folder_path
         self.folder_name = get_folder_name_from_path(folder_path)
@@ -371,6 +373,9 @@ def flush_to_json_string(self) -> str:
         data["relevant_apis"] = self.relevant_apis
         data["snippets"] = self.snippets
         data["title"] = self.title
+        if self.has_teardown:
+            # Only write has_teardown when it is True.
+            data["has_teardown"] = self.has_teardown
         if self.offline_data:
             # Only write offline_data when it is not empty.
             data["offline_data"] = self.offline_data

Scripts/CI/common.py

@@ -52,6 +52,10 @@ def run_check(path: str) -> None:
     # The special rule not to compare the redirect_from.
     checker.redirect_from = json_data['redirect_from']
 
+    # The special rule not to compare has_teardown.
+    if 'has_teardown' in json_data:
+        checker.has_teardown = json_data['has_teardown']
+
     # The special rule not to compare offline_data.
     if 'offline_data' in json_data:
         checker.offline_data = json_data['offline_data']

Scripts/CI/metadata_checker.py

@@ -43,6 +43,9 @@ private struct SampleMetadata: Decodable {
     let keywords: [String]
     /// The relevant APIs of the sample.
     let relevantApis: [String]
+    /// A Boolean value indicating whether a sample has an action that needs to
+    /// be performed when its view disappears.
+    let hasTeardown: Bool? // swiftlint:disable:this discouraged_optional_boolean
 }
 
 extension SampleMetadata {
@@ -130,6 +133,7 @@ private let sampleStructs = sampleMetadata
             var snippets: [String] { \(sample.snippets) }
             var tags: Set<String> { \(sample.tags) }
             \(portalItemIDs.isEmpty ? "" : "var hasDependencies: Bool { true }\n")
+            var hasTeardown: Bool { \(sample.hasTeardown ?? false) }
             func makeBody() -> AnyView { .init(\(sample.viewName)()) }
         }
         """

Scripts/GenerateSampleViewSourceCode.swift

@@ -49,6 +49,9 @@ def flush_to_json_file(self, path_to_json: str) -> None:
         data["relevant_apis"] = self.relevant_apis
         data["snippets"] = self.snippets
         data["title"] = self.title
+        if self.has_teardown:
+            # Only write has_teardown when it is True.
+            data["has_teardown"] = self.has_teardown
         if self.offline_data:
             # Only write offline_data when it is not empty.
             data["offline_data"] = self.offline_data

Scripts/create-metadata-from-README.py

@@ -26,7 +26,7 @@ The sample will load the KML file automatically. The data shown should refresh a
 
 ## Offline data
 
-This sample uses the "radar.kmz" file, which can be found on [ArcGIS Online](https://arcgisruntime.maps.arcgis.com/home/item.html?id=600748d4464442288f6db8a4ba27dc95).
+This sample uses the "radar.kmz" file, which can be found on [ArcGIS Online](https://www.arcgis.com/home/item.html?id=600748d4464442288f6db8a4ba27dc95).
 
 ## About the data
 

Shared/Samples/Add KML layer with network links/README.md

@@ -34,21 +34,23 @@ struct AddKMLLayerView: View {
                             Text(source.label)
                         }
                     }
-                    .onChange(of: selectedLayerSource, perform: setKMLLayer(forSource:))
+                    .onChange(of: selectedLayerSource) {
+                        setKMLLayer(for: selectedLayerSource)
+                    }
                 }
             }
             .task {
                 // Loads all the KML layers when the sample opens.
                 let kmlLayers = [model.urlLayer, model.localFileLayer, model.portalItemLayer]
                 await kmlLayers.load()
 
-                setKMLLayer(forSource: selectedLayerSource)
+                setKMLLayer(for: selectedLayerSource)
             }
     }
 
     /// Sets a KML layer on the map.
     /// - Parameter source: The source that was used to create the KML layer.
-    private func setKMLLayer(forSource source: KMLLayerSource) {
+    private func setKMLLayer(for source: KMLLayerSource) {
         let kmlLayer = switch source {
         case .url: model.urlLayer
         case .localFile: model.localFileLayer
@@ -74,7 +76,7 @@ private extension AddKMLLayerView {
 
         /// A KML layer created from a web URL.
         let urlLayer: KMLLayer = {
-            let url = URL(string: "https://www.wpc.ncep.noaa.gov/kml/noaa_chart/WPC_Day1_SigWx.kml")!
+            let url = URL(string: "https://www.spc.noaa.gov/products/outlook/SPC_outlooks.kml")!
             let kmlDataset = KMLDataset(url: url)
             return KMLLayer(dataset: kmlDataset)
         }()

Shared/Samples/Add KML layer/AddKMLLayerView.swift

@@ -32,7 +32,7 @@ This sample uses the [US State Capitals](https://www.arcgis.com/home/item.html?i
 
 This sample displays three different KML files:
 
-* From URL: This is a map of the significant weather outlook produced by NOAA/NWS. It uses KML network links to always show the latest data.
+* From URL: This is a map of the convective outlook produced by NOAA/NWS Storm Prediction Center. It uses KML network links to always show the latest data.
 * From local file: This is a map of U.S. state capitals. It doesn't define an icon, so the default pushpin is used for the points.
 * From portal item: This is a map of U.S. states.
 

Shared/Samples/Add KML layer/README.md

@@ -0,0 +1,28 @@
+// 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
+//
+//   https://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.
+
+import ArcGIS
+import SwiftUI
+
+struct AddOpenStreetMapLayerView: View {
+    @State private var map = Map(basemapStyle: .openOSMStyle)
+    
+    var body: some View {
+        MapView(map: map)
+    }
+}
+
+#Preview {
+    AddOpenStreetMapLayerView()
+}