0Pricing
Swift Academy · Lekcja

Cele binarne i XCFrameworks

Dystrybuowanie zamkniętego kodu jako XCFramework i używanie go jako celu binarnego.

Cele binarne i XCFrameworks to bezpłatna lekcja Swift Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Swift Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Swift Academy zawiera 4 lekcji w sumie.

Czym jest target binarny

Target binarny dystrybuuje prekompilowany framework (XCFramework) zamiast kodu źródłowego, chroniąc zastrzeżone implementacje.

// Package.swift:
.binaryTarget(
  name: "ClosedSDK",
  path: "Frameworks/ClosedSDK.xcframework"
)

Czym jest XCFramework?

XCFramework łączy wiele wycinków platform (iOS, macOS, symulator) w jedno archiwum przeznaczone do dystrybucji.

// XCFramework structure:
// ClosedSDK.xcframework/
// ├── ios-arm64/
// ├── ios-arm64_x86_64-simulator/
// └── macos-arm64_x86_64/

Tworzenie XCFramework

Należy zbudować archiwa dla każdej platformy, a następnie połączyć je za pomocą xcodebuild -create-xcframework.

xcodebuild archive -scheme MySDK -destination "generic/platform=iOS" -archivePath ios.xcarchive SKIP_INSTALL=NO
xcodebuild archive -scheme MySDK -destination "generic/platform=iOS Simulator" -archivePath sim.xcarchive SKIP_INSTALL=NO
xcodebuild -create-xcframework \
  -framework ios.xcarchive/Products/Library/Frameworks/MySDK.framework \
  -framework sim.xcarchive/Products/Library/Frameworks/MySDK.framework \
  -output MySDK.xcframework

Zdalny cel binarny z sumą kontrolną

Należy odwołać się do zdalnie hostowanego pliku ZIP XCFramework wraz z jego sumą kontrolną SHA-256, aby zweryfikować integralność.

.binaryTarget(
  name: "ClosedSDK",
  url: "https://cdn.example.com/ClosedSDK-1.0.0.xcframework.zip",
  checksum: "abc123def456..."
)

Obliczanie sumy kontrolnej

Należy użyć swift package compute-checksum, aby wygenerować sumę kontrolną SHA-256 pliku ZIP.

swift package compute-checksum ClosedSDK-1.0.0.xcframework.zip
# Outputs: abc123def456...

Używanie celów binarnych w aplikacji

Należy dodać cel binarny jako zależność na liście dependencies innego celu, tak samo jak cel źródłowy.

.target(
  name: "MyApp",
  dependencies: [
    .target(name: "ClosedSDK")
  ]
)

Importowanie XCFramework

Moduł należy zaimportować w kodzie Swift dokładnie tak samo jak każdy inny import.

import ClosedSDK

let result = ClosedSDK.ProcessData(input: myData)

Wymagania dotyczące manifestu prywatności

Firma Apple wymaga, aby dystrybuowane w App Store pakiety XCFramework zawierały manifest PrivacyInfo.xcprivacy z wykazem używanych interfejsów API.

// ClosedSDK.xcframework/
// ├── ios-arm64/ClosedSDK.framework/
// │   └── PrivacyInfo.xcprivacy
// └── ...

Kompilacje debugowe a wydaniowe

Podczas korzystania z XCFramework nie można śledzić kodu źródłowego w debugerze — widoczne są tylko symbole. Pliki dSYM można dołączyć, aby umożliwić symbolikację awarii.

// Distribute dSYMs alongside XCFramework for crash reporting:
// ClosedSDK-1.0.0.xcframework.zip
// ClosedSDK-1.0.0.dSYM.zip

Wersjonowanie XCFramework

Należy używać wersjonowania semantycznego w nazwie pliku oraz wersji pakietu SPM, aby użytkownicy mogli przypinać zgodne wersje.

// ClosedSDK-1.2.0.xcframework.zip
// In Package.swift:
// .package(url: "...", from: "1.2.0")

XCFramework a pakiety źródłowe

XCFramework należy stosować w przypadku kodu własnościowego, dużych wstępnie skompilowanych zestawów SDK lub wrapperów C/C++. Pakiety źródłowe są odpowiednie dla otwartoźródłowego kodu Swift.

// XCFramework: proprietary analytics SDK, vendor-provided libraries
// Source: open-source Alamofire, SwiftUI components

Szybkie sprawdzenie

Dlaczego podczas deklarowania zdalnego celu binarnego w Package.swift należy dołączyć sumę kontrolną?

Podsumowanie lekcji

Cele binarne umożliwiają dystrybucję wstępnie skompilowanych pakietów XCFramework bez kodu źródłowego. Należy je zbudować za pomocą xcodebuild -create-xcframework, umieścić plik ZIP na serwerze, obliczyć jego sumę kontrolną za pomocą swift package compute-checksum i zadeklarować go w Package.swift. Na potrzeby przesłania do App Store należy dołączyć plik PrivacyInfo.xcprivacy.

Często zadawane pytania

Czy lekcja „Cele binarne i XCFrameworks” jest bezpłatna?

Tak — pełny tekst „Cele binarne i XCFrameworks” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Swift Academy, przejdź na CoddyKit PRO. Kurs Swift Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Cele binarne i XCFrameworks”?

Dystrybuowanie zamkniętego kodu jako XCFramework i używanie go jako celu binarnego. Ćwiczysz Swift Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Swift Academy?

Nie wymagamy żadnego doświadczenia. Swift Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Cele binarne i XCFrameworks”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Swift Academy?

Tak. Każda lekcja Swift Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Package.swift: cele, produkty i zależności
  2. Pakiety lokalne i moduły funkcji
  3. Cele binarne i XCFrameworks
  4. Wersjonowanie, rozwiązywanie konfliktów i wtyczki Swift
← Powrót do Swift Academy