diff --git a/apple-platforms/Package.swift b/apple-platforms/Package.swift new file mode 100644 index 000000000..8a2259083 --- /dev/null +++ b/apple-platforms/Package.swift @@ -0,0 +1,19 @@ +// swift-tools-version: 6.2 + +import PackageDescription + +let package = Package( + name: "SwiftApplePlatforms", + products: [ + .library(name: "SwiftApplePlatforms", targets: ["SwiftApplePlatforms"]) + ], + dependencies: [ + .package(url: "https://github.com/swiftlang/swift-docc-plugin", from: "1.1.0") + ], + targets: [ + .target( + name: "SwiftApplePlatforms", + path: "Sources" + ) + ] +) diff --git a/apple-platforms/Snippets/.gitkeep b/apple-platforms/Snippets/.gitkeep new file mode 100644 index 000000000..e69de29bb diff --git a/apple-platforms/Sources/SwiftApplePlatforms.docc/Documentation.md b/apple-platforms/Sources/SwiftApplePlatforms.docc/Documentation.md new file mode 100644 index 000000000..e67250aaa --- /dev/null +++ b/apple-platforms/Sources/SwiftApplePlatforms.docc/Documentation.md @@ -0,0 +1,15 @@ +# ``SwiftApplePlatforms`` + +Build and ship apps for iOS, iPadOS, macOS, watchOS, tvOS, and visionOS. + +@Metadata { + @DisplayName("Apple platforms") + @TitleHeading("") +} + +Swift is the primary language for building apps across Apple's platforms, with +deep integration into Xcode, Apple's SDKs, and frameworks like SwiftUI and +UIKit. + +Visit [Apple Developer Documentation](https://developer.apple.com/documentation/technologies) +for platform-specific APIs, frameworks, and guides. diff --git a/apple-platforms/Sources/_empty.swift b/apple-platforms/Sources/_empty.swift new file mode 100644 index 000000000..1830a90de --- /dev/null +++ b/apple-platforms/Sources/_empty.swift @@ -0,0 +1,13 @@ +//===----------------------------------------------------------------------===// +// +// This source file is part of the Swift.org open source project +// +// Copyright (c) 2026 Apple Inc. and the Swift.org project authors +// Licensed under Apache License v2.0 +// +// See LICENSE.txt for license information +// See CONTRIBUTORS.txt for the list of Swift.org project authors +// +// SPDX-License-Identifier: Apache-2.0 +// +//===----------------------------------------------------------------------===// diff --git a/scripts/navigation.json b/scripts/navigation.json index fcfc59ab4..6ab35b335 100644 --- a/scripts/navigation.json +++ b/scripts/navigation.json @@ -31,6 +31,7 @@ "title": "Platforms", "modules": [ { "source": "swift-android", "path": "/documentation/swiftandroid", "title": "Android" }, + { "source": "swift-apple-platforms", "path": "/documentation/swiftappleplatforms", "title": "Apple platforms" }, { "source": "embedded-swift", "path": "/documentation/embeddedswift", "title": "Embedded Swift" }, { "source": "swift-linux", "path": "/documentation/swiftlinux", "title": "Linux" }, { "source": "swift-wasm", "path": "/documentation/wasmguide", "title": "WebAssembly (Wasm)"} diff --git a/scripts/sources.json b/scripts/sources.json index 154a730be..521ec6543 100644 --- a/scripts/sources.json +++ b/scripts/sources.json @@ -90,6 +90,12 @@ "ref": "main", "targets": ["SwiftAndroid"] }, + { + "id": "swift-apple-platforms", + "type": "local", + "path": "apple-platforms", + "targets": ["SwiftApplePlatforms"] + }, { "id": "swift-server-todos-tutorial", "type": "git",