Uwagi do wydania macOS 27: wycofania, zmiany łamiące i poprawki

macOS 27 Golden Gate ukazał się w poniedziałek 14 września 2026 roku jako build 26A428, a jego SDK, build 26A425, trafił tego samego dnia do Xcode 27 (27A266a). Uwagi do wydania od Apple obejmują 86 obszarów z nagłówkami i 272 wpisy: 68 nowych funkcji, 173 rozwiązane problemy, 18 znanych problemów i 13 wycofań. Ten wpis czyta je z perspektywy dewelopera aplikacji na Maca: wpisy, które zmieniają działanie aplikacji w chwili zlinkowania jej z SDK 27, zmiany na poziomie systemu, które uderzają bez żadnej rekompilacji, 13 wycofań skonfrontowanych z nagłówkami i interfejsami Swift samego SDK oraz to, co mogłem, a czego nie mogłem sprawdzić na Macu, który wciąż działa na 26.6.2. Wpis o wydaniu GA Golden Gate omawia Rosettę i domyślną architekturę arm64 instalatora; ten omawia resztę.¹²³

TL;DR

• Buildy. Urządzenie 26A428, SDK 26A425; numer SDK nie jest numerem urządzenia, co ma znaczenie, gdy zgłoszenie błędu prosi o jeden z nich. Indeks uwag do wydania Apple i kanał wydań nie wymieniają według stanu na 26 września żadnego macOS 27.0.1; najnowsze wpisy to 27 oraz beta 2 wersji 27.2 (26B5091g) z 21 września.¹³⁷
• Zachowanie po zlinkowaniu z 27. Trzynaście zmian wpływa na działanie aplikacji w chwili zlinkowania jej z SDK 27: ukryte obrazy pozycji menu niebędące symbolami, przy czym pozycje złożone wyłącznie z obrazu tracą swój wyjątek; NSOpenPanel wyprowadzający canChooseFiles z typów zawartości; pozycja menu Layout Orientation przeniesiona pod Font; akcesoria paska tytułu rysowane poza swoimi granicami; prompty TextField przyjmujące stylizację; TextRenderer w zaznaczalnym Text; modyfikatory kontrolek resetowane w widokach sheet i popover; obliczanie bezpiecznego obszaru w containerRelativeFrame; LabeledContent jako podtytuł pozycji menu; TabView w inspektorach przechodzący na styl kart; List przyjmujący upuszczenia, które wcześniej odrzucał; newDocument przyjmujący dokument w pamięci; a w Mac Catalyst nakaz cyklu życia opartego na scenach i rozszerzone przywracanie stanu.²
• Bez rekompilacji. Obrazy symboli w pozycjach menu znikają w każdej aplikacji zlinkowanej z macOS 26.0 lub nowszym, a w menu SwiftUI i UIKit bez żadnego warunku dotyczącego SDK; rozpoznawacze gestów stają się wyłączną własnością pierwszej hierarchii widoków trafionej przez hit-test, zawieszone gesty same się anulują, bazowe locationInView: zwraca NSZeroPoint, launchd według uwag nie wczytuje już list właściwości objętych kwarantanną, kończy się bezpośredni dostęp do bazy TCC, dostęp do kontenerów innych zespołów jest odmawiany bez pytania, XProtect może odgradzać dane aplikacji, ruch MDM i aktualizacji oprogramowania wymaga TLS 1.2 z szyframi na poziomie ATS, a aplikacje, które użytkownik ustawił na „Open using Rosetta”, uruchamiają się natywnie.²
• 13 wycofań, w tym cztery dotyczące API. PHAssetResource.originalFilename ostrzega tylko przy deployment target 27.0 (macos(10.15, 27) w nagłówku); FileDocument ma miękką wersję 100000.0 i nigdy nie ostrzega; calendar.deleteEvents zniknęło z interfejsu App Intents, więc stara nazwa się nie kompiluje; DVDPlayback wbrew uwadze wciąż jest w SDK 27.0 jako stub, z nagłówkami i modułem, a przy minimum poniżej 27.0 ostrzega, przy 27.0 zaś zawodzi. Pozostałe dziewięć to zachowanie systemu, aplikacje, formaty lub pozostałości po betach, a nie API.²³
• SDK potwierdza nowy AppKit. NSRefreshController, NSTextSelectionManager, właściwości role z NSToolbarItemGroup.Role i NSSegmentedControlRole, preferredImageVisibility, cancellableByScrollGesture oraz opcja NSApplicationPresentationDisableScreenCornerInteractions mają adnotację macos(27.0); frameworki DiskImageKit i NowPlaying są obecne; System ma swój typ Stat; StoreKit ma assigned i BundledSubscription, a tam, gdzie uwagi piszą assignmentRevoked, interfejs mówi assignmentRevocation.³

Który build jest który?

Uwagi zaczynają się od dwóch zdań o zakresie, „The macOS 27 SDK provides support to develop apps for Mac computers running macOS 27 Golden Gate. The SDK comes bundled with Xcode 27, available from the Mac App Store,” (SDK macOS 27 pozwala tworzyć aplikacje na Maki z macOS 27 Golden Gate i jest dołączony do Xcode 27, dostępnego w Mac App Store) po czym przechodzą przez 86 obszarów z nagłówkami. Policzenie pozycji listy pod każdym nagłówkiem daje 68 nowych funkcji, 173 rozwiązane problemy, 18 znanych problemów i 13 wycofań. Na Siri przypada 26 rozwiązanych i sześć znanych, na SwiftUI 21 nowych i 19 rozwiązanych, na AppKit osiem nowych i 18 rozwiązanych, na Core AI 11 rozwiązanych, a na StoreKit Testing in Xcode 10 rozwiązanych i dwa znane.² Wpis o uwagach do iOS 27 omawia stronę iPhone’a, gdzie te same wpisy SwiftUI występują w brzmieniu dla iOS; wpis o Xcode 27 omawia narzędzia.

Uwagi do bety 2 wersji 27.2, datowane na 21 września, są krótkie: awaria uzupełniania kodu w Xcode oznaczona jako naprawiona, jedno wycofanie w AppKit („The EnablePasteboardPrivacyDeveloperPreview user default has been removed.”, czyli usunięto to ustawienie domyślne), znany problem Notifications przy czystych instalacjach, znany problem Shortcuts, dwa znane problemy StoreKit Testing opisane niżej przeniesione do naprawionych oraz jedna nowa poprawka StoreKit Testing dotycząca uprawnienia do ofert wprowadzających po SKTestSession.clearTransactions(). Poza tymi wpisami StoreKit Testing nic w nich nie dotyka wpisów 27.0 z tego tekstu.⁴

Co zmienia się w chwili zlinkowania z SDK macOS 27?

Apple uzależnia zmiany zachowania od SDK, z którym aplikacja jest linkowana, więc te zmiany nie wpływają na już wydany build, a wszystkie uruchamiają się przy pierwszym archiwum z Xcode 27. Przytaczam uwagę do każdej z nich:²

• Obrazy menu niebędące symbolami i wyjątek pustego tytułu. Zmiana dotycząca obrazów symboli, opisana niżej, nie wymaga rekompilacji; resztę przynosi rekompilacja. „For applications linked on the macOS 27 SDK, both symbol and non-symbol menu item images are now automatically hidden. For applications linked on earlier SDKs, non-symbol images remain automatically visible, preserving compatibility with existing application behavior.” (przy SDK macOS 27 automatycznie ukrywane są obrazy zarówno symboliczne, jak i niesymboliczne; przy wcześniejszych SDK obrazy niesymboliczne pozostają widoczne). I w drugą stronę dla starych buildów: „For applications linked on SDKs prior to macOS 27, NSMenu now automatically shows menu item images if the menu item title and attributed title are both empty. This preserves existing application behavior when the image is the only representation of the menu item content. When linking against the macOS 27 SDK, these images will automatically be hidden.” (przy SDK sprzed macOS 27 NSMenu pokazuje obraz, gdy tytuł i tytuł z atrybutami są puste; po zlinkowaniu z SDK macOS 27 te obrazy zostaną ukryte). Pozycja złożona wyłącznie z obrazu wymaga po rekompilacji ustawienia preferredImageVisibility na .visible. Mój wpis o obrazach w menu przeprowadza przez audyt.
• Panele otwierania same ustalają, co można wybrać. Oznaczone jako naprawione: „In apps built with the macOS 27.0 SDK, setting allowedContentTypes and treatsFilePackagesAsDirectories on NSOpenPane updates canChooseFiles and canChooseDirectories based on whether the requested types are file or directory types.” (w aplikacjach zbudowanych z SDK 27.0 ustawienie tych dwóch właściwości aktualizuje canChooseFiles i canChooseDirectories zależnie od tego, czy żądane typy są typami plików, czy katalogów). (Uwaga zawiera literówkę w nazwie klasy.) Panel otwierania, który ustawiał typy zawartości, a potem polegał na jawnym canChooseDirectories = true, to przypadek do ponownego przetestowania.
• Layout Orientation zmienia miejsce. „NSTextView’s menuForEvent: now returns a context menu in which the Layout Orientation menu item, and its submenu, are located inside the Font submenu. Because this change can cause compatibility issues with some shipping applications, it applies only to applications linked on the macOS 27 SDK.” (pozycja Layout Orientation wraz z podmenu trafia do podmenu Font, i to tylko w aplikacjach zlinkowanych z SDK macOS 27). Kod, który odnajduje tę pozycję, przechodząc po menu, psuje się po rekompilacji.
• Akcesoria paska tytułu wychodzą poza krawędzie. „When an app is linked on macOS 27.0 or later, NSTitlebarAccessoryViewController is now allowed to draw outside its bounds by default, supporting effects such as shadows and interactive glass effects. During reveal animations, accessories might be clipped for the duration of the animation or when the accessory is hidden.” (domyślnie może rysować poza swoimi granicami, co umożliwia cienie i efekty szkła; podczas animacji odsłaniania akcesoria mogą być przycinane).
• Prompty TextField przyjmują stylizację. „In apps built with the macOS 27.0 SDK, TextField respects custom font and color styling applied to its prompt. Apply styling to the Text provided to TextField’s prompt parameter at initialization.” (TextField respektuje niestandardową czcionkę i kolor promptu; styl należy nadać obiektowi Text przekazanemu w parametrze prompt).
• Zaznaczalny Text dostaje TextRenderer. „In apps built with the iOS 27.0 and macOS 27.0 SDKs, selectable Text views now support TextRenderer,” a sąsiedni wpis o poprawce mówi, że niestandardowy renderer „now takes effect on a Text view that also has .textSelection(.enabled) applied.” (działa teraz także w Text z włączonym zaznaczaniem).
• Widoki sheet i popover. Oznaczone jako naprawione: „In apps built with the 27.0 SDKs, the controlSize, buttonSizing, buttonRepeatBehavior, menuIndicatorVisibility, and ButtonBorderShape environment values are now reset to their default values in sheets and popovers.” (te wartości środowiska wracają do domyślnych wewnątrz widoków sheet i popover). Sheet, który dziedziczył .controlSize(.large) po widoku prezentującym, przestaje to robić.
• containerRelativeFrame. Oznaczone jako naprawione dla buildów 27.0: „incorrectly accounts for safe-area insets on a ScrollView’s non-scrollable axis, causing the calculated scrollable content size to be too small.” (błędnie uwzględniało wcięcia bezpiecznego obszaru na nieprzewijanej osi ScrollView, przez co obliczony rozmiar treści był za mały). Kierunek tego wpisu jest niejasny, bo jego przykład opisuje treść wchodzącą w bezpieczny obszar, a nie kurczącą się; każde containerRelativeFrame wewnątrz ScrollView warto przetestować ponownie po rekompilacji.
• Menu dostają podtytuły. „In apps built with the 27.0 SDKs, a LabeledContent view used inside a Menu maps its value to the platform menu item’s subtitle.” (wartość LabeledContent wewnątrz Menu staje się podtytułem pozycji menu).
• TabView w inspektorach. „In apps built with the latest SDKs, the appearance of TabViews in inspectors now matches their appearance in sidebars, and in both contexts automatically uses the new .tabs picker style.” (w inspektorach wyglądają tak jak na paskach bocznych i w obu miejscach automatycznie używają nowego stylu .tabs).
• List przyjmuje więcej upuszczeń. „In macOS apps built with the macOS 27 SDK, List accepts drops in two cases that previously didn’t work: drags with compatible transfer representations are accepted into reorderable content even when the .reorderableItem transfer type isn’t present, and a .dropDestination(...) modifier declared on a list item now performs the drop.” (przyjmuje upuszczenia w dwóch przypadkach, które wcześniej nie działały: zgodne przeciągnięcia do treści z możliwością zmiany kolejności nawet bez .reorderableItem oraz .dropDestination(...) zadeklarowany na elemencie listy). Obsługa upuszczenia, która nigdy nie uruchamiała się na Macu, może zacząć się uruchamiać.
• newDocument przyjmuje instancję. „In macOS apps built with the macOS 27 SDK, the action retrieved from the \.newDocument environment value accepts an in-memory ReadableDocument produced by an autoclosure. SwiftUI presents a new document window populated with the supplied instance, instead of invoking the document group’s default factory.” (akcja przyjmuje ReadableDocument z pamięci, a SwiftUI otwiera okno z tą instancją zamiast wywoływać domyślną fabrykę grupy dokumentów).
• Mac Catalyst. Wśród wycofań UIKit: „Apps built with the latest SDK must adopt the scene-based life cycle or they fail to launch,” (aplikacje zbudowane z najnowszym SDK muszą przyjąć cykl życia oparty na scenach, inaczej się nie uruchomią) to ten sam nakaz, który wpis o scenach omawia dla iOS, oraz „When linked on iOS 27, tvOS 27, macCatalyst 27, or visionOS 27 SDKs, you can use UIScene.extendStateRestoration and UIScene.completeStateRestoration to extend state restoration” na przejście z tła na pierwszy plan. Osobno, i bez warunku SDK, „Catalyst apps now behave like AppKit apps when you switch to them with no open windows” (aplikacje Catalyst zachowują się jak aplikacje AppKit po przełączeniu na nie bez otwartych okien); nie tworzą już okna, chyba że zostaną aktywowane z Docka lub Spotlight.

Dwa wpisy, jeden w sekcji SwiftUI i jeden w Swift Charts, należą do tej listy, choć zależą od kompilatora, a nie od linkowania. Przepisane makro @State „back-deploys to iOS 17 aligned OSes” (jest przenoszone wstecz do systemów zrównanych z iOS 17) i zmienia to, co kompiluje się w Xcode 27: niektóre deklaracje z wartością początkową, które dodatkowo przypisują wartość w init, przestają się kompilować, w słowach Apple „some such cases,” (niektóre takie przypadki) a syntetyzowany prywatny inicjalizator znika. Wpis o makrze @State zawiera audyt. Wpis Swift Charts, oznaczony jako naprawiony, opisuje ostrzeżenie i możliwą awarię w czasie działania: „When your project has a minimum deployment target lower than 27.0, using conditionals inside a Chart closure produces the warning” o zgodności z _ConditionalContent, „and the app might crash at runtime when that content is loaded.” (przy minimalnym deployment target poniżej 27.0 warunki w domknięciu Chart dają ostrzeżenie, a aplikacja może ulec awarii przy wczytaniu tej treści). Cytowane ostrzeżenie ma pustą nazwę platformy, co wygląda na diagnostykę z bet, i nie udało mi się go odtworzyć: Chart, którego domknięcie rozgałęzia się przez if między BarMark a LineMark, przeszedł type-check bez żadnej diagnostyki wobec SDK 27.0 zarówno przy deployment target 26.0, jak i 27.0, 26 września. Część wpisu o awarii w czasie działania to tekst Apple i pozostaje tu nieprzetestowana.²³

Co zmienia się bez żadnej rekompilacji?

Druga połowa uwag opisuje system operacyjny, a te zmiany dotyczą pliku binarnego wydanego w zeszłym roku.²

• Obrazy symboli w menu znikają. AppKit: „By default, NSMenu hides all menu item symbol images” (domyślnie NSMenu ukrywa wszystkie obrazy symboli w pozycjach menu), a zmiana dotyczy aplikacji „to applications linked on macOS 26.0 and later”, więc build z Xcode 26 traci obrazy symboli na maszynie z 27 bez rekompilacji; preferredImageVisibility w NSMenuItem, API_AVAILABLE(macos(27.0)), służy do nadpisania, a pole wyboru „macOS 26.0 only” w inspektorze xib jest drugim przełącznikiem. SwiftUI: „By default, SwiftUI now hides all menu item symbol images in most contexts, while non-symbol images remain visible,” (SwiftUI domyślnie ukrywa obrazy symboli w większości kontekstów, a pozostałe obrazy zostają widoczne) z labelStyle(_:) i .titleAndIcon jako przełącznikiem, który je zachowuje, i bez warunku SDK we wpisie. UIKit: „On iPadOS 27.0 and macOS 27.0, the menu bar and context menus present a reduced set of menu item images and do not display images set on menu elements by default,” (pasek menu i menu kontekstowe pokazują ograniczony zestaw obrazów i domyślnie nie wyświetlają obrazów ustawionych na elementach menu) z preferredImageVisibility w UIMenuElement i znowu bez warunku SDK. Nagłówek zgadza się z odczytaniem tego jako zmiany systemowej: komentarz przy NSMenuItem.image mówi, że „in macOS 27 and later, AppKit determines the visibility of menu item images, and will typically hide images.” (od macOS 27 o widoczności tych obrazów decyduje AppKit i zwykle je ukrywa).³
• Gesty stają się wyłączne. „Only the initial hit-tested view hierarchy will activate gesture recognizers until all gestures terminate. A new exclusiveGestureBehavior property on NSView allows you to opt-out of this exclusive behavior on a per-view-hierarchy basis. Further, the Info.plist key NSViewGestureRecognizerIsExclusive allows you to opt-out for the entire app.” (dopóki wszystkie gesty się nie zakończą, rozpoznawacze aktywuje tylko pierwsza hierarchia widoków trafiona przez hit-test; exclusiveGestureBehavior pozwala zrezygnować z tego dla danej hierarchii, a klucz Info.plist dla całej aplikacji). Towarzyszący klucz, NSGestureRecognizerSuppressesMainMenuActions, pozwala akcjom menu głównego działać w trakcie aktywnego gestu, a „stuck gestures are automatically cancelled after user input has ended for a few seconds,” (zawieszone gesty są automatycznie anulowane kilka sekund po zakończeniu interakcji użytkownika) przy czym ustawienie domyślne NSCrashOnStuckGestureTimeout zamienia to w awarię podczas debugowania. Rozpoznawacz na widoku nadrzędnym, który dawniej uruchamiał się razem z rozpoznawaczem widoku podrzędnego, teraz czeka.
• Własne rozpoznawacze muszą same określać położenie. Oznaczone jako naprawione: bazowe locationInView: w NSGestureRecognizer „now returns NSZeroPoint and logs an error pointing the developer at the missing override. Custom NSGestureRecognizer subclasses must provide their own locationInView: implementation.” (zwraca teraz NSZeroPoint i zapisuje w logu błąd wskazujący brakujące nadpisanie; własne podklasy muszą implementować locationInView:). Osobny wpis opisuje diagnostyczne ustawienie domyślne NSGestureRecognizerCrashOnMissingOverrides jako przeznaczone „to help developers find NSGestureRecognizer subclasses that are missing required overrides to ensure that they always reach a terminal state” (do wyszukiwania podklas, którym brakuje nadpisań potrzebnych, by zawsze dochodziły do stanu końcowego); czy wychwytuje ono także brak locationInView:, uwagi nie mówią. Ponadto NSClickGestureRecognizers „with a click count greater than 1 will send an action before their multi-click timeout has elapsed.” (z liczbą kliknięć większą niż 1 wyślą akcję przed upływem limitu czasu wielokrotnego kliknięcia).
• launchd i kwarantanna. Oznaczone jako naprawione: „launchd no longer supports loading launchd property list files with the quarantine extended attribute.” (launchd nie wczytuje już list właściwości z rozszerzonym atrybutem kwarantanny). Wpisy Apple o poprawkach czasem opisują stary błąd, a czasem nową regułę; czytany jako reguła, pobrany plik plist agenta, zainstalowany z tym atrybutem, przestaje się wczytywać.
• TCC. W sekcji Deprecations: „Apps can no longer access the local TCC database directly.” (aplikacje nie mogą już bezpośrednio sięgać do lokalnej bazy TCC).
• Kontenery i XProtect. W sekcji System Integrity Protection: „Accessing files in other developer teams’ app data containers and app group containers no longer prompts the user for authorization; such accesses are denied by default and can be managed by the user in Privacy & Security settings.” (dostęp do plików w kontenerach innych zespołów nie wywołuje już prośby o zgodę; jest domyślnie odmawiany, a użytkownik zarządza nim w Privacy & Security). Oraz: „XProtect may now restrict access to app data that is commonly targeted by malicious software.” (XProtect może ograniczać dostęp do danych aplikacji, na które często celuje złośliwe oprogramowanie). Znany problem w sekcji Privacy & Security dodaje, że „a process without a bundle ID cannot be granted access to specific app data containers or app group containers owned by other developer teams,” (procesowi bez bundle ID nie można przyznać dostępu do kontenerów innych zespołów) z Full Disk Access jako wyjściem awaryjnym.
• TLS dla ruchu zarządzanego. „Starting in 27.0 operating systems, select system processes now enforce stricter network security (TLS) requirements,” (od systemów 27.0 wybrane procesy systemowe egzekwują ostrzejsze wymagania TLS) z wymienieniem MDM, DDM, Automated Device Enrollment, instalacji profili, instalacji aplikacji i aktualizacji oprogramowania; „Servers must support TLS 1.2 at minimum, using cipher suites and certificates that meet App Transport Security (ATS) requirements.” (serwery muszą obsługiwać co najmniej TLS 1.2 z zestawami szyfrów i certyfikatami spełniającymi wymagania ATS). Audyt TLS zawiera listę kontrolną.
• Rosetta. „On launch, Applications previously set to “Open using Rosetta” by a user will have the application launch natively,” (aplikacje, które użytkownik ustawił na otwieranie przez Rosettę, uruchamiają się natywnie) „If Rosetta was previously installed, it is not automatically restored after upgrading to macOS 27.0,” (jeśli Rosetta była zainstalowana, po aktualizacji nie jest automatycznie przywracana) a pakiety instalacyjne bez hostArchitecture „will now default to arm64.” Wpis o wydaniu GA odtwarza to domyślne zachowanie instalatora na 26.6.2.
• Neural Engine w tle. Wpis znajduje się na stronie macOS i zaczyna się od „iOS 27 includes Neural Engine improvements for Apple Intelligence capable devices,” więc należy go czytać jako uwagę wspólną dla platform: „The system now restricts background access to the Neural Engine, similar to GPU usage restrictions,” (system ogranicza dostęp do Neural Engine w tle, podobnie jak w przypadku GPU) oraz „Neural Engine memory usage is now attributed to your app process instead of the system, and appears in the Allocations instrument.” (pamięć Neural Engine jest przypisywana procesowi aplikacji i widać ją w instrumencie Allocations). Drugi wpis Core AI mówi, że dostęp w tle „requires the new entitlement: “com.apple.developer.background-tasks.continued-processing.inference”.” (wymaga tego nowego uprawnienia).
• Archiwa logów. „Unified Logging System archives generated on 27.0 releases cannot be read on macOS 26.1 or earlier due to an updated archive format. macOS 26.2 or later is required to read these archives.” (archiwów wygenerowanych w 27.0 nie da się odczytać w macOS 26.1 ani starszym; potrzebny jest 26.2 lub nowszy). Proces wsparcia, który otwiera pakiety .logarchive od klientów na starszym Macu, potrzebuje co najmniej 26.2.
• Obietnice plików sprawdzają asercję. Oznaczone jako naprawione: receivePromisedFilesAtDestination: „asserts that it is called during -prepareForDragOperation:, -performDragOperation:, or -concludeDragOperation:. If receivePromisedFilesAtDestination:... is called at other times, your application will throw an exception and terminate.” (sprawdza, czy jest wywoływane w trakcie jednej z tych trzech metod; wywołane w innym momencie zgłasza wyjątek i kończy aplikację). Odbiorca, który odkładał to wywołanie na późniejszy obieg pętli zdarzeń, teraz kończy działanie.

Które API są wycofane w 27.0?

Uwagi zawierają 13 wpisów pod nagłówkami Deprecations w 11 obszarach. Wycofanie w uwagach do wydania to zdanie; wycofanie w SDK to adnotacja dostępności, którą czyta kompilator, i jedno nie zawsze mówi to samo co drugie. Każdy wpis sprawdziłem z nagłówkami i interfejsami Swift w SDK macOS 27.0 w Xcode 27:²³

Jedno miękkie wycofanie leży poza nagłówkami Deprecations, to samo, które mają uwagi do iOS: .roundedBorder ma w macOS deprecated: 100000.0 z komunikatem „Use textFieldStyle(.bordered) with textInputBorderShape(.roundedRectangle)”, co pasuje do wpisu w New Features wprowadzającego TextInputBorderShape.³

Twarde wycofania są cichsze, niż się wydaje. Kompilator porównuje wersję wycofania z deployment target, a nie z SDK, więc macos(10.15, 27) daje ostrzeżenie tylko w targecie, którego minimalny macOS to 27.0. Sprawdziłem type-checkiem jeden plik, który odczytuje originalFilename, dostosowuje typ do FileDocument i stosuje .roundedBorder, wobec SDK 27.0 przy dwóch targetach: przy arm64-apple-macos26.0 skompilował się bez żadnej diagnostyki, a przy arm64-apple-macos27.0 dał dokładnie jedną, 'originalFilename' was deprecated in macOS 27: Use filename instead. FileDocument i .roundedBorder milczały w obu przypadkach.³ Aplikacja na Maca z realistycznym minimum nie usłyszy o żadnym z nich od kompilatora; ostrzeżeniem jest grep z listy poniżej.

Co nowego zmienia kod, który już istnieje?

Pull to refresh na Macu. „In macOS 27.0, AppKit adds NSRefreshController, providing pull-to-refresh functionality for NSScrollView. You can set it with NSScrollView.refreshController, configure a target or action to handle user-initiated refreshes, and call endRefreshing when the refresh completes or beginRefreshing to start one programmatically.” (AppKit dodaje odświeżanie przez pociągnięcie w NSScrollView: ustawia się je przez refreshController, konfiguruje target lub akcję, a po zakończeniu wywołuje endRefreshing, zaś beginRefreshing uruchamia je programowo). Klasa i właściwość refreshController w NSScrollView mają w SDK API_AVAILABLE(macos(27.0)).²³

Zaznaczanie tekstu gestami. „NSTextSelectionManager provides common text selection interactions (click, drag, shift-click, double/triple-click word/line/paragraph selection) to a NSView with a set of NSGestureRecognizers rather than overriding NSEvent mouse methods. NSTextView now uses NSTextSelectionManager” (zapewnia typowe interakcje zaznaczania tekstu za pomocą rozpoznawaczy gestów zamiast nadpisywania metod myszy, a NSTextView już z niego korzysta) oraz „Existing NSTextView subclasses that override mouseDown: continue to work through a binary-compatible fallback path.” (istniejące podklasy nadpisujące mouseDown: działają dalej dzięki zgodnej binarnie ścieżce zapasowej). Klasa ma macos(27.0).²³ W połączeniu z opisaną wyżej regułą wyłączności własny widok tekstowy nadpisujący mouseDown: działa dalej, ale rozpoznawacz gestów dołączony obok niego może teraz ustępować rozpoznawaczom menedżera.

Role dla kart. NSToolbarItemGroup i NSSegmentedControl dostają właściwość role, w obu przypadkach API_AVAILABLE(macos(27.0)), z NSToolbarItemGroup.Role (automatic, tabs, valueSelection) i NSSegmentedControlRole; uwagi mówią, że rola tabs jest „read by VoiceOver as “tabs”” (odczytywana przez VoiceOver jako karty) i ma „a distinct visual appearance.” (odrębny wygląd). TabsPickerStyle w SwiftUI to ten sam pomysł, a inspektory przyjmują go automatycznie po rekompilacji.²³

Hot Corners wyłączone. „NSApplication.presentationOptions now includes the .disableScreenCornerInteractions option, which you can use to disable Hot Corners.” (zawiera opcję wyłączającą Hot Corners). W nagłówku to NSApplicationPresentationDisableScreenCornerInteractions, API_AVAILABLE(macos(27.0)), bit 15 maski opcji, a komentarz nad nią mówi „.autoHideDock or .hideDock must also be set for this option to take effect.” (aby opcja zadziałała, trzeba też ustawić .autoHideDock lub .hideDock).²³

Dokumenty, przepisane. „In apps built with the 27.0 SDKs, the new ReadableDocument and WritableDocument protocols support asynchronous reading and writing, progress reporting, and direct access to document URLs,” (nowe protokoły obsługują asynchroniczny odczyt i zapis, raportowanie postępu i bezpośredni dostęp do URL dokumentów) przy czym Document łączy oba, a FileDocument i ReferenceFileDocument są „now deprecated.” Trzy wpisy pochodne zmieniają istniejące zgodności: domknięcie makeFileWrapper w FileWrapperDocumentWriter „now receives a second argument, previous: FileWrapper?,” i „Existing call sites must update their closures to accept the new parameter” (istniejące miejsca wywołań muszą zaktualizować domknięcia, aby przyjmowały nowy parametr); wymagania read(from:progress:) i write(content:to:previous:progress:) są „declared with @concurrent instead of nonisolated,” więc „Conforming types that previously used nonisolated should switch to @concurrent to match” (typy, które używały nonisolated, powinny przejść na @concurrent); a URLDocumentConfiguration „no longer conforms to Sendable.” Przeciążenie fileExporter eksportuje kolekcję wartości WritableDocument w jednym oknie dialogowym. Znany problem w tym samym obszarze: postęp „might not be presented.” (może nie być wyświetlany).²

Obrazy, obramowania, suwaki, menu. „AsyncImage now automatically caches downloaded images using HTTP caching protocols,” (automatycznie buforuje pobrane obrazy zgodnie z protokołami buforowania HTTP) z inicjalizatorami URLRequest i View.asyncImageURLSession(_:) do sterowania tym. TextInputBorderShape i textInputBorderShape(_:) pojawiają się razem ze stylem .bordered. „On macOS, the Slider implementation no longer uses NSSlider,” a obramowane przyciski Menu i Picker „no longer use NSPopUpButton in their implementation,” więc własny kod rysujący lub kod dostępności, który zakładał kontrolkę AppKit pod spodem, nie ma już czego szukać. GeometryProxy dostaje concentricCornerRadii i concentricCornerRadii(in:). Modyfikatory alert i confirmationDialog z elementem danych sięgają teraz wstecz do macOS 12.0.²

StoreKit. „Offer code redemption APIs now return a VerificationResult when redemption completes,” (API realizacji kodów ofertowych zwracają po zakończeniu VerificationResult) Transaction.OwnershipType.assigned i Transaction.RevocationType.assignmentRevoked „support volume purchases,” (obsługują zakupy hurtowe) a „Transaction query methods now additionally return transactions assigned to the Managed Apple Account.” (metody zapytań Transaction zwracają też transakcje przypisane do Managed Apple Account). Product.ProductType zyskuje pakiety (Bundles) i zestawy (Suites) subskrypcji z Product.SubscriptionInfo.BundledSubscription, a partnerName i partnerId trafiają do informacji Advanced Commerce. Interfejs zawiera assigned i BundledSubscription; przypadek unieważnienia nie jest zapisany tak, jak zapisuje go uwaga. Żaden plik w SDK nie zawiera assignmentRevoked; interfejs StoreKit deklaruje public static var assignmentRevocation w Transaction.RevocationType z surową wartością ASSIGNMENT_REVOKE. Przypadek ma @available(macOS 26.4, *) z @backDeployed(before: macOS 27.0), więc .assignmentRevocation przechodzi type-check przy targecie 27.0, a poniżej tego minimum wymaga if #available(macOS 26.4, *); nazwa z uwagi nie ma członka, do którego mogłaby się rozwiązać, przy żadnym targecie. Aplikacja na Maca, która filtruje transakcje według typu własności, widzi teraz trzecią wartość.²³

stat w Swift. „System now provides Swift APIs for the C stat, lstat, fstat, and fstatat system calls,” (System udostępnia API Swift dla tych wywołań systemowych C) z typem Stat i FilePath.stat(); uwagi wymieniają też jako naprawiony konflikt, w którym „Custom FilePath or FileDescriptor extensions that make unqualified calls to stat() or stat(_) (without the Darwin. qualification) might conflict with the new Swift stat() instance methods.” (własne rozszerzenia wywołujące stat() bez kwalifikatora Darwin. mogą kolidować z nowymi metodami instancji). public struct Stat jest w interfejsie System.²³

Obrazy dysków, maszyny wirtualne, Gatekeeper. „The new DiskImageKit framework provides Swift APIs for creating and managing standalone and stacked disk images in the Apple Sparse Image Format (ASIF) and raw disk image formats, for use with the Virtualization framework via VZDiskImageStorageDeviceAttachment.” (nowy framework udostępnia API Swift do tworzenia samodzielnych i warstwowych obrazów dysków w formatach ASIF i raw oraz zarządzania nimi, do użycia z Virtualization). Framework jest w SDK. Przekierowanie portów vmnet w Virtualization „now support[s] port forwarding when communicating over loopback,” (obsługuje teraz przekierowanie portów przez loopback) a spctl dostaje polecenie purge, „which will clean up Gatekeeper database entries for apps and executables which are no longer mounted.” (które czyści wpisy bazy Gatekeeper dotyczące aplikacji i plików wykonywalnych, które nie są już zamontowane). Wpis o kontenerach to miejsce, gdzie API obrazów dysków przydadzą się każdemu, kto skryptuje maszyny wirtualne.²³

Kontrolery do gier, wideo, Metal. „The PlayStation® Access™ controller is now supported on macOS, iPadOS, and iOS.” VTLowLatencySuperResolutionScalerConfiguration „now supports a 1.5x scale factor,” a interpolacja klatek „supports arbitrary source dimensions up to 1080p.” Dwie poprawki w Metal dotyczą samplerów clamp-to-edge zwracających zero, jedna z nich specyficzna dla „the Apple 10 GPU family.”²

Foundation. Poprawka NSURL pojawia się tu w tym samym brzmieniu co w uwagach do iOS: „+[NSURL URLWithString:] no longer double-encodes the % of valid percent-escape sequences when encoding other invalid characters.” (nie koduje już podwójnie znaku % w poprawnych sekwencjach procentowych, gdy koduje inne niedozwolone znaki). We wpisie o iOS pokazałem, że poprawka podąża za systemem, na którym działa kod, i że build tego samego kodu na Maca wciąż dawał stary wynik %2520 na macOS 26.6.2; na 27.0 należy spodziewać się nowego wyniku, a na każdym 26.x starego.²

Bezpieczeństwo sprzętowe. „arm64e.x1 introduces additional hardware security and performance instructions, including CPA2 for stronger MIE protection,” (wprowadza dodatkowe instrukcje bezpieczeństwa i wydajności, w tym CPA2 dla silniejszej ochrony MIE) na „Mac computers with M6 or later chips”; lista targetów stubu DVDPlayback opisana wyżej pokazuje nazwę tego wycinka w praktyce. Wpis o arm64e.x1 omawia ustawienie builda.²³

Znane problemy, które warto uwzględnić w planach

• Encje photos.asset przestają się kompilować. „Existing entities that conformed to @AppEntity(schema: .photos.asset) in prior releases might no longer compile in the 27 SDKs because new properties were added to the schema in this release.” (encje zgodne z tym schematem mogą się nie kompilować z SDK 27, bo do schematu dodano nowe właściwości). Obejściem jest przyjęcie tych właściwości za sprawdzeniem dostępności; wpis o uwagach do iOS wymienia 12 właściwości, których wymaga procesor metadanych, a uwagi do macOS zawierają ten sam wpis.²
• Schemat audio i Siri. „If you adopt the Audio App Schema domain, you might have trouble playing your content using Siri.” (po przyjęciu tej domeny odtwarzanie treści przez Siri może sprawiać problemy). Obejście: „Adopt an IntentValueQuery that takes the AudioSearch input, or index your entities in Spotlight.” (użyć IntentValueQuery przyjmującego AudioSearch albo zaindeksować encje w Spotlight).²
• SpotlightSearchTool przepełnia model na urządzeniu. Bez konfiguracji „the tool’s description and parameter schema alone exceed the on-device model’s context window before any prompt is added” (sam opis narzędzia i schemat parametrów przekraczają okno kontekstu modelu lokalnego, zanim dojdzie jakikolwiek prompt); rozwiązaniem jest zawężony przewodnik, np. .focused(.documents).²
• Files & Folders dla procesów bez pakietu. Procesowi bez bundle ID „cannot be granted access to specific app data containers or app group containers owned by other developer teams,” a obejściem Apple jest Full Disk Access „for the duration of the requirement.” (na czas trwania potrzeby). Chodzi o narzędzia wiersza poleceń, które czytają kontener innej aplikacji.²
• Niepodpisane rozszerzenia Safari. Podczas ich tworzenia „unsigned extensions might not appear until rebuilt when using the “Allow Unsigned Extensions” checkbox.” (niepodpisane rozszerzenia mogą nie pojawić się do czasu przebudowania).²
• Testowanie StoreKit. „Changing the storefront or locale using SKTestSession doesn’t propagate through Storefront.updates,” (zmiana sklepu lub ustawień regionalnych przez SKTestSession nie jest propagowana) a nieudane zakupy „might display error dialogs even when dialogsDisabled is set to true.” (mogą wyświetlać okna błędów mimo wyłączenia dialogów). Oba figurują jako naprawione w uwagach do bety 2 wersji 27.2, które dodają nowy: zakup subskrypcji wewnątrz pakietu „incorrectly allows the user to unbundle instead of throwing an error.” (błędnie pozwala wyodrębnić ją z pakietu zamiast zgłosić błąd).²⁴
• Shortcuts. Intencja używająca Duration lub LPLinkMetadata „might fail” (może zawieść) w „Describe a change”, a parametr UnionValue z dwoma typami liczbowymi pokazuje opcję dwukrotnie; należy zadeklarować jeden.²
• Dysk startowy z macOS 11. „When a Mac is running macOS 11.0, you might not be able to select the boot volume of macOS 27.0 or later as the startup disk in System Settings.” (na macOS 11.0 może nie dać się wybrać woluminu z macOS 27.0 jako dysku startowego w System Settings). Obejściem jest wybór dysku startowego przyciskiem zasilania.²
• Siri, sześć wpisów. Wybór zdjęć po wyszukiwaniu, „Ask Siri” pojawiające się tam, gdzie Siri jest wyłączona, brak poleceń głosowych dla konkretnych zdjęć, niepełne fragmenty Maps, liczniki przy dodawaniu do albumów oraz obrazy encji niebędące SF Symbols, które nie pojawiają się w wynikach Siri dla aplikacji innych firm. Ten ostatni warto sprawdzić, jeśli encje mają własne obrazy.²

Czego nie mogłem uruchomić

Ten Mac działa na macOS 26.6.2, a maszyny z 27 wciąż nie mam. Każde zachowanie systemu w tym wpisie to tekst Apple, zacytowany i oznaczony jako taki; nic powyżej nie twierdzi, że system macOS 27 coś zrobił, bo to widziałem. Uruchomić mogłem SDK: Xcode 27 (27A266a) zawiera SDK macOS 27.0 (26A425) na każdym Macu, na którym da się go zainstalować, więc adnotacje w nagłówkach, interfejsy Swift, foldery frameworków i trzy przebiegi type-checku są prawdziwe i datowane na 26 września. Dwa miejsca, w których SDK i uwagi się nie zgadzają, stub DVDPlayback i pisownia przypadku unieważnienia, podaję jako to, co pokazuje SDK, a nie jako twierdzenia o tym, co maszyna z 27 zrobi w czasie działania.³

Co zrobiłbym w tym tygodniu

1. Raz zarchiwizować aplikację z Xcode 27 i przed notaryzacją przejść po niej z listą zmian po zlinkowaniu z 27: obrazy pozycji menu, każdy panel otwierania ustawiający typy zawartości, każdy kod przechodzący po menu kontekstowym NSTextView, akcesoria paska tytułu oraz każdy sheet, który dziedziczył modyfikatory kontrolek.²
2. Przetestować gesty na maszynie z 27, zanim zrobią to użytkownicy: rozpoznawacz na widoku nadrzędnym, który dawniej uruchamiał się razem z rozpoznawaczem widoku podrzędnego, jest teraz wyłączny, a własna podklasa NSGestureRecognizer bez locationInView: zwraca punkt początkowy i zapisuje błąd w logu. Warto obserwować konsolę pod kątem tego błędu, który według Apple generuje AppKit; ustawienie domyślne NSGestureRecognizerCrashOnMissingOverrides jest opisane dla podklas, które nie dochodzą do stanu końcowego, a uwagi nie mówią, że obejmuje locationInView:.²
3. Przeszukać grepem kod pod kątem originalFilename, FileDocument, ReferenceFileDocument, .roundedBorder, deleteEvents i import DVDPlayback; pierwsze ostrzega tylko przy targecie 27.0, trzy kolejne są miękkie i ciche, deleteEvents już nie istnieje, a import DVDPlayback staje się błędem w dniu podniesienia minimum do 27.0.³
4. Jeśli agent lub demon jest dostarczany przez pobranie, usunąć atrybut kwarantanny z listy właściwości podczas instalacji albo instalować ją ścieżką, która nigdy go nie niesie; uwagi Apple wymieniają launchd w 27 jako nie wczytujący już takich plików.²
5. Jeśli aplikacja czyta kontener innego zespołu, usunąć ten kod albo poprowadzić go przez Full Disk Access; monitu już nie ma, a domyślną odpowiedzią jest odmowa.²
6. Zapisywać numer builda w zgłoszeniach błędów z obu miejsc: ProcessInfo na maszynie i SystemVersion.plist z SDK na Macu budującym. Różnią się, 26A428 wobec 26A425, a poprawka obecna w jednym może nie być obecna w drugim.³

Często zadawane pytania

Kiedy ukazał się macOS 27 i jaki to build?

W poniedziałek 14 września 2026 roku, jako build 26A428, w kanale wydań Apple obok Xcode 27 i pozostałych systemów 27.0. SDK w Xcode 27 identyfikuje się jako 26A425.¹³

Czy macOS 27.0.1 już jest?

Nie według stanu na 26 września 2026 roku. Indeks uwag do wydania macOS od Apple wymienia „macOS 27 Golden Gate Release Notes” i „macOS 27.2 Golden Gate Beta 2 Release Notes” i nic pomiędzy nimi, a kanał wydań nie zawiera 27.0.1 dla żadnej platformy. Gdy się ukaże, ten wpis dostanie datowaną notkę.¹⁷

Gdzie są uwagi do wydania macOS 27?

Na stronie dokumentacji deweloperskiej Apple, w sekcji macOS Release Notes, na jednej stronie dla tego wydania, zatytułowanej „macOS 27 Golden Gate Release Notes”, z 86 obszarami, najpierw General, potem od Accessory Access do XQuartz. Uwagi do bety 27.2 to osobna, znacznie krótsza strona.²⁴

Co jest wycofane w macOS 27?

Trzynaście wpisów pod nagłówkami Deprecations: PHAssetResource.originalFilename, FileDocument, zmiana nazwy calendar.deleteEvents, framework DVDPlayback, Encrypted HFS+, bezpośredni dostęp do bazy TCC, nakaz cyklu życia opartego na scenach w Catalyst, trzy wpisy o Rosetcie, AirPort Utility w czystych instalacjach, uwaga o becie USDKit i uwaga o języku Weather Highlights. Tylko pierwsze cztery dotyczą API. originalFilename dostaje ostrzeżenie tylko przy deployment target 27.0, FileDocument milczy, deleteEvents się nie kompiluje, a DVDPlayback ostrzega przy minimum poniżej 27.0 i zawodzi przy 27.0.²³

Czy aplikację trzeba przebudować dla macOS 27?

Nie, a to właśnie przebudowanie zmienia część zachowania. Wpisy dotyczące zlinkowania z 27 uruchamiają się dopiero przy archiwizacji z SDK 27; zmiany w gestach, launchd, TCC, kontenerach, TLS i Rosetcie dotyczą każdego pliku binarnego na maszynie z 27, niezależnie od przebudowania, a aplikacja zlinkowana z macOS 26.0 lub nowszym już tam traci obrazy symboli w menu.²

Czy DVDPlayback zniknął z SDK?

Nie z SDK 27.0 na dysku: folder frameworka, jego .tbd, nagłówki i module map są obecne w MacOSX27.0.sdk z Xcode 27. Jego funkcje są oznaczone jako niedostępne przy deployment target 27.0 i wycofane od 10.15 poniżej tego progu, więc projekt z minimum 27.0 nie może się z nim zbudować, co zgadza się z uwagą; projekt z niższym minimum nadal może, z ostrzeżeniem.³

Co zmieniło się w Mac Catalyst na macOS 27?

Obowiązuje nakaz cyklu życia opartego na scenach, UIScene.extendStateRestoration i completeStateRestoration są dostępne po zlinkowaniu z SDK macCatalyst 27, aplikacje Catalyst nie tworzą już okna po przełączeniu na nie bez otwartego okna, chyba że zostaną aktywowane z Docka lub Spotlight, UIStepper działa w idiomie Maca, a brakujące przyciski paska narzędzi na pasku bocznym figurują jako naprawione. Uwagi do bety Xcode 27.2 dodają zastrzeżenie, że tamtejszy SDK macOS „incorrectly report[s] 27.1 as a valid deployment target,” (błędnie podaje 27.1 jako prawidłowy deployment target) i że buildy Catalyst z 27.1 lub 27.2 „may be unable to use newly introduced API.” (mogą nie móc korzystać z nowo wprowadzonych API).²⁵

Źródła