Notas de versão do macOS 27: descontinuações, quebras e correções

O macOS 27 Golden Gate saiu na segunda-feira, 14 de setembro de 2026, como o build 26A428, com o SDK, build 26A425, dentro do Xcode 27 (27A266a) no mesmo dia. As notas de versão da Apple cobrem 86 áreas com título e 272 entradas: 68 recursos novos, 173 problemas resolvidos, 18 problemas conhecidos e 13 descontinuações. Este post as lê pensando em quem desenvolve para Mac: as entradas que mudam o que um app faz no momento em que ele é vinculado ao SDK 27, as mudanças no nível do sistema que pegam sem recompilação nenhuma, as 13 descontinuações conferidas contra os próprios headers e interfaces Swift do SDK, e o que eu consegui e não consegui verificar em um Mac que ainda roda o 26.6.2. O post sobre o GA do Golden Gate cobre o Rosetta e o padrão arm64 do instalador; este cobre o resto.¹²³

TL;DR

• Builds. Dispositivo 26A428, SDK 26A425; o número do SDK não é o número do dispositivo, o que importa quando um relatório de bug pede um deles. O índice de notas de versão da Apple e o feed de lançamentos não listam nenhum macOS 27.0.1 até 26 de setembro; as entradas mais recentes são o 27 e o beta 2 do 27.2 (26B5091g), de 21 de setembro.¹³⁷
• Comportamento ao vincular com o 27. Treze mudanças alteram o que um app faz no momento em que ele é vinculado ao SDK 27: imagens de itens de menu que não são símbolos ficam ocultas, e itens só com imagem perdem a exceção; NSOpenPanel derivando canChooseFiles dos tipos de conteúdo; o item de menu Layout Orientation indo para baixo de Font; acessórios da barra de título desenhando fora dos próprios limites; prompts de TextField aceitando estilo; TextRenderer em Text selecionável; modificadores de controle redefinidos dentro de sheets e popovers; o cálculo de área segura do containerRelativeFrame; LabeledContent virando subtítulo de menu; TabView em inspectors passando para o estilo de abas; List aceitando drops que antes recusava; newDocument recebendo um documento em memória; e, no Mac Catalyst, a obrigatoriedade do ciclo de vida por cenas e a restauração de estado estendida.²
• Sem precisar recompilar. As imagens de símbolo dos itens de menu somem em qualquer app vinculado ao macOS 26.0 ou posterior, e nos menus de SwiftUI e UIKit sem condição de SDK nenhuma; os gesture recognizers passam a ser exclusivos da primeira hierarquia de views atingida pelo hit-test, gestos travados se cancelam sozinhos, o locationInView: base retorna NSZeroPoint, o launchd aparece como não carregando mais property lists em quarentena, o acesso direto ao banco de dados do TCC acaba, o acesso a containers de outros times é negado sem pedir permissão, o XProtect pode cercar dados de apps, o tráfego de MDM e de atualização de software exige TLS 1.2 com cifras no nível do ATS, e apps que o usuário configurou como “Open using Rosetta” abrem de forma nativa.²
• 13 descontinuações, quatro delas de API. PHAssetResource.originalFilename só avisa com deployment target 27.0 (macos(10.15, 27) no header); FileDocument carrega a versão branda 100000.0 e nunca avisa; calendar.deleteEvents sumiu da interface do App Intents, então o nome antigo não compila; o DVDPlayback continua no SDK 27.0 como stub, com headers e módulo, ao contrário do que diz a nota, e avisa abaixo de um mínimo de 27.0 e falha com ele. As outras nove são comportamento do sistema, apps, formatos ou restos dos betas, não API.²³
• O SDK confirma o novo AppKit. NSRefreshController, NSTextSelectionManager, as propriedades role com NSToolbarItemGroup.Role e NSSegmentedControlRole, preferredImageVisibility, cancellableByScrollGesture e a opção NSApplicationPresentationDisableScreenCornerInteractions estão todos anotados como macos(27.0); os frameworks DiskImageKit e NowPlaying estão presentes; o System tem seu tipo Stat; o StoreKit tem assigned e BundledSubscription, e onde as notas dizem assignmentRevoked a interface diz assignmentRevocation.³

Qual build é qual?

As notas abrem com duas frases de escopo, “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,” (o SDK do macOS 27 permite desenvolver apps para Macs com macOS 27 Golden Gate e vem junto com o Xcode 27, disponível na Mac App Store) e depois percorrem 86 áreas com título. Contar os itens de lista sob cada título dá 68 recursos novos, 173 problemas resolvidos, 18 problemas conhecidos e 13 descontinuações. A Siri responde por 26 resolvidos e seis conhecidos, o SwiftUI por 21 novos e 19 resolvidos, o AppKit por oito novos e 18 resolvidos, o Core AI por 11 resolvidos, e o StoreKit Testing in Xcode por 10 resolvidos e dois conhecidos.² O post sobre as notas do iOS 27 cobre o lado do iPhone, onde as mesmas entradas de SwiftUI aparecem com a redação do iOS; o post sobre o Xcode 27 cobre o toolchain.

As notas do beta 2 do 27.2, datadas de 21 de setembro, são curtas: um travamento do autocompletar de código do Xcode listado como corrigido, uma descontinuação no AppKit (“The EnablePasteboardPrivacyDeveloperPreview user default has been removed.”, ou seja, esse user default foi removido), um problema conhecido de Notifications em instalações limpas, um problema conhecido de Shortcuts, os dois problemas conhecidos de StoreKit Testing citados mais abaixo passando para corrigidos, e uma correção nova de StoreKit Testing sobre a elegibilidade para ofertas introdutórias depois de SKTestSession.clearTransactions(). Fora essas entradas de StoreKit Testing, nada nelas toca as entradas do 27.0 deste post.⁴

O que muda no momento em que você vincula com o SDK do macOS 27?

A Apple condiciona as mudanças de comportamento ao SDK com que o app é vinculado, então elas não fazem nada com o build que você já publicou, e todas disparam no primeiro archive feito no Xcode 27. Cito a nota de cada uma:²

• Imagens de menu que não são símbolos, e a exceção do título vazio. A mudança das imagens de símbolo, mais abaixo, não precisa de recompilação; a recompilação leva o resto. “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.” (com o SDK do macOS 27, imagens de símbolo e as que não são símbolos ficam ocultas automaticamente; com SDKs anteriores, as que não são símbolos continuam visíveis). E no sentido contrário para builds antigos: “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.” (com SDKs anteriores ao macOS 27, o NSMenu mostra a imagem se o título e o título com atributos estiverem vazios; ao vincular com o SDK do macOS 27, essas imagens ficam ocultas). Um item só com imagem precisa de preferredImageVisibility em .visible depois da recompilação. Meu post sobre as imagens de menu percorre a auditoria.
• Painéis de abertura deduzem o que pode ser escolhido. Listado como corrigido: “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.” (com o SDK 27.0, definir essas duas propriedades atualiza canChooseFiles e canChooseDirectories conforme os tipos pedidos sejam de arquivo ou de diretório). (A nota escreve o nome da classe errado.) Um painel de abertura que definia tipos de conteúdo e depois contava com um canChooseDirectories = true explícito é o formato a testar de novo.
• Layout Orientation muda de lugar. “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.” (o item Layout Orientation e seu submenu vão para dentro do submenu Font, só em apps vinculados ao SDK do macOS 27). Código que encontra esse item percorrendo o menu quebra na recompilação.
• Acessórios da barra de título vazam. “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.” (por padrão pode desenhar fora dos próprios limites, para sombras e efeitos de vidro; durante animações de revelação, os acessórios podem ser recortados).
• Prompts de TextField aceitam estilo. “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.” (respeita fonte e cor personalizadas no prompt; aplique o estilo ao Text passado no parâmetro prompt).
• Text selecionável ganha TextRenderer. “In apps built with the iOS 27.0 and macOS 27.0 SDKs, selectable Text views now support TextRenderer,” e a entrada de correção ao lado diz que um renderer personalizado “now takes effect on a Text view that also has .textSelection(.enabled) applied.” (agora funciona em um Text que também tem a seleção habilitada).
• Sheets e popovers. Listado como corrigido: “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.” (esses valores de ambiente voltam ao padrão dentro de sheets e popovers). Um sheet que herdava .controlSize(.large) de quem o apresenta deixa de herdar.
• containerRelativeFrame. Listado como corrigido para builds do 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.” (considerava errado os insets de área segura no eixo não rolável de um ScrollView, e o tamanho calculado do conteúdo ficava pequeno demais). O sentido da entrada não é claro, já que o exemplo dela descreve conteúdo que se estende para dentro da área segura em vez de encolher; teste de novo qualquer containerRelativeFrame dentro de um ScrollView na recompilação.
• Menus ganham subtítulos. “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.” (o valor de um LabeledContent dentro de um Menu vira o subtítulo do item de menu).
• TabView em inspectors. “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.” (em inspectors, ficam iguais às das barras laterais e, nos dois contextos, usam automaticamente o novo estilo .tabs).
• List aceita mais drops. “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.” (aceita drops em dois casos que antes não funcionavam: arrastes compatíveis em conteúdo reordenável mesmo sem .reorderableItem, e um .dropDestination(...) declarado em um item da lista). Um handler de drop que nunca disparava no Mac pode começar a disparar.
• newDocument recebe uma instância. “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.” (a ação aceita um ReadableDocument em memória, e o SwiftUI abre uma janela com essa instância em vez de chamar a factory padrão do grupo de documentos).
• Mac Catalyst. Nas descontinuações do UIKit: “Apps built with the latest SDK must adopt the scene-based life cycle or they fail to launch,” (apps compilados com o SDK mais recente precisam adotar o ciclo de vida por cenas ou não abrem) a mesma obrigatoriedade que o post sobre cenas cobre para o iOS, e “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” até a transição de segundo plano para primeiro plano. Separadamente, e sem condição de SDK, “Catalyst apps now behave like AppKit apps when you switch to them with no open windows” (apps Catalyst se comportam como apps AppKit quando você alterna para eles sem janelas abertas); eles não criam mais uma janela, a menos que sejam ativados pelo Dock ou pelo Spotlight.

Duas entradas, uma em SwiftUI e outra em Swift Charts, pertencem a esta lista, embora dependam do compilador e não do vínculo. A reescrita da macro @State “back-deploys to iOS 17 aligned OSes” (é retroportada para os sistemas alinhados ao iOS 17) e muda o que compila no Xcode 27: algumas declarações que têm valor inicial e também atribuem no init deixam de compilar, nas palavras da Apple “some such cases,” (alguns desses casos) e o inicializador privado sintetizado desaparece. O post sobre a macro @State tem a auditoria. E a entrada de Swift Charts, listada como corrigida, descreve um aviso e um possível travamento em tempo de execução: “When your project has a minimum deployment target lower than 27.0, using conditionals inside a Chart closure produces the warning” sobre a conformidade com _ConditionalContent, “and the app might crash at runtime when that content is loaded.” (com deployment target mínimo abaixo de 27.0, condicionais dentro de um Chart geram o aviso e o app pode travar ao carregar esse conteúdo). O aviso citado traz um nome de plataforma vazio, o que parece um diagnóstico dos betas, e eu não consegui reproduzi-lo: um Chart cuja closure ramifica com if entre um BarMark e um LineMark passou no type-check sem nenhum diagnóstico contra o SDK 27.0, tanto com deployment target 26.0 quanto com 27.0, em 26 de setembro. A metade da entrada sobre o travamento em tempo de execução é texto da Apple e fica sem teste aqui.²³

O que muda sem recompilar nada?

A outra metade das notas descreve o sistema operacional, e isso vale para o binário que você publicou no ano passado.²

• As imagens de símbolo dos menus somem. AppKit: “By default, NSMenu hides all menu item symbol images” (por padrão, o NSMenu oculta todas as imagens de símbolo dos itens) e a mudança vale “to applications linked on macOS 26.0 and later”, então um build do Xcode 26 perde as imagens de símbolo em uma máquina com 27 sem recompilar; preferredImageVisibility no NSMenuItem, API_AVAILABLE(macos(27.0)), é o override, e a caixa “macOS 26.0 only” no inspector do xib é a segunda chave. SwiftUI: “By default, SwiftUI now hides all menu item symbol images in most contexts, while non-symbol images remain visible,” (por padrão, o SwiftUI oculta as imagens de símbolo na maioria dos contextos, e as demais imagens continuam visíveis) com labelStyle(_:) e .titleAndIcon como a chave para mantê-las, e sem condição de SDK na entrada. 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,” (a barra de menus e os menus de contexto mostram um conjunto reduzido de imagens e, por padrão, não exibem as definidas nos elementos de menu) com preferredImageVisibility no UIMenuElement, e de novo sem condição de SDK. O header concorda com a leitura de que é uma mudança do sistema: o comentário em NSMenuItem.image diz que “in macOS 27 and later, AppKit determines the visibility of menu item images, and will typically hide images.” (a partir do macOS 27, o AppKit decide a visibilidade dessas imagens e normalmente as oculta).³
• Os gestos ficam exclusivos. “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.” (só a primeira hierarquia de views atingida pelo hit-test ativa gesture recognizers até todos os gestos terminarem; exclusiveGestureBehavior permite sair disso por hierarquia, e a chave do Info.plist, para o app inteiro). Uma chave complementar, NSGestureRecognizerSuppressesMainMenuActions, deixa as ações do menu principal dispararem enquanto um gesto está ativo, e “stuck gestures are automatically cancelled after user input has ended for a few seconds,” (gestos travados são cancelados automaticamente alguns segundos depois que a interação do usuário termina) com o default NSCrashOnStuckGestureTimeout para transformar isso em crash durante a depuração. Um recognizer em uma view pai que antes disparava junto com o de uma view filha agora espera.
• Recognizers personalizados precisam se localizar sozinhos. Listado como corrigido: o locationInView: base de NSGestureRecognizer “now returns NSZeroPoint and logs an error pointing the developer at the missing override. Custom NSGestureRecognizer subclasses must provide their own locationInView: implementation.” (agora retorna NSZeroPoint e registra um erro apontando o override ausente; subclasses personalizadas precisam implementar o próprio locationInView:). Outra entrada descreve o default de diagnóstico NSGestureRecognizerCrashOnMissingOverrides como fornecido “to help developers find NSGestureRecognizer subclasses that are missing required overrides to ensure that they always reach a terminal state” (para ajudar a encontrar subclasses sem os overrides necessários para sempre chegarem a um estado terminal); se ele também pega um locationInView: ausente, as notas não dizem. E os NSClickGestureRecognizers “with a click count greater than 1 will send an action before their multi-click timeout has elapsed.” (com contagem de cliques maior que 1 enviam a ação antes de esgotar o tempo de clique múltiplo).
• launchd e quarentena. Listado como corrigido: “launchd no longer supports loading launchd property list files with the quarantine extended attribute.” (o launchd não carrega mais property lists com o atributo estendido de quarentena). As entradas de correção da Apple às vezes descrevem o bug antigo e às vezes a regra nova; lida como regra, uma plist de agente baixada que foi instalada com o atributo deixa de carregar.
• TCC. Em Deprecations: “Apps can no longer access the local TCC database directly.” (apps não podem mais acessar diretamente o banco de dados local do TCC).
• Containers e XProtect. Em 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.” (acessar arquivos em containers de outros times não pede mais autorização: o acesso é negado por padrão e o usuário o gerencia em Privacy & Security). E: “XProtect may now restrict access to app data that is commonly targeted by malicious software.” (o XProtect pode restringir o acesso a dados de apps que costumam ser alvo de malware). O problema conhecido de Privacy & Security acrescenta que “a process without a bundle ID cannot be granted access to specific app data containers or app group containers owned by other developer teams,” (um processo sem bundle ID não pode receber acesso a containers de outros times) com Full Disk Access como alternativa.
• TLS para tráfego gerenciado. “Starting in 27.0 operating systems, select system processes now enforce stricter network security (TLS) requirements,” (a partir dos sistemas 27.0, certos processos do sistema exigem requisitos de TLS mais rígidos) citando MDM, DDM, Automated Device Enrollment, instalação de perfis, instalação de apps e atualizações de software; “Servers must support TLS 1.2 at minimum, using cipher suites and certificates that meet App Transport Security (ATS) requirements.” (os servidores precisam suportar no mínimo TLS 1.2, com suítes de cifras e certificados que atendam aos requisitos do ATS). A auditoria de TLS tem o checklist.
• Rosetta. “On launch, Applications previously set to “Open using Rosetta” by a user will have the application launch natively,” (apps que o usuário configurou para abrir com o Rosetta abrem de forma nativa) “If Rosetta was previously installed, it is not automatically restored after upgrading to macOS 27.0,” (se o Rosetta estava instalado, ele não é restaurado automaticamente depois da atualização) e pacotes de instalação sem hostArchitecture “will now default to arm64.” O post sobre o GA reproduz esse padrão do instalador no 26.6.2.
• Neural Engine em segundo plano. A entrada está na página do macOS e começa com “iOS 27 includes Neural Engine improvements for Apple Intelligence capable devices,” então leia como uma nota compartilhada entre plataformas: “The system now restricts background access to the Neural Engine, similar to GPU usage restrictions,” (o sistema restringe o acesso ao Neural Engine em segundo plano, como já faz com a GPU) e “Neural Engine memory usage is now attributed to your app process instead of the system, and appears in the Allocations instrument.” (a memória do Neural Engine passa a ser atribuída ao processo do seu app e aparece no instrumento Allocations). Uma segunda entrada de Core AI diz que o acesso em segundo plano “requires the new entitlement: “com.apple.developer.background-tasks.continued-processing.inference”.” (exige esse novo entitlement).
• Arquivos de log. “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.” (arquivos gerados no 27.0 não podem ser lidos no macOS 26.1 ou anterior; é preciso o 26.2 ou posterior). Um fluxo de suporte que abre pacotes .logarchive de clientes em um Mac mais antigo precisa no mínimo do 26.2.
• Promessas de arquivo fazem uma asserção. Listado como corrigido: 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.” (verifica se é chamado durante um desses três métodos; chamado em outro momento, lança uma exceção e encerra o app). Um receptor que adiava a chamada para uma volta posterior do run loop agora é encerrado.

Quais APIs estão descontinuadas no 27.0?

As notas trazem 13 entradas sob títulos de Deprecations em 11 áreas. Uma descontinuação em notas de versão é uma frase; uma descontinuação no SDK é uma anotação de disponibilidade que o compilador lê, e as duas nem sempre dizem a mesma coisa. Conferi cada entrada contra os headers e as interfaces Swift do SDK do macOS 27.0 no Xcode 27:²³

Uma descontinuação branda fica fora dos títulos de Deprecations, a mesma que as notas do iOS trazem: .roundedBorder é deprecated: 100000.0 no macOS com a mensagem “Use textFieldStyle(.bordered) with textInputBorderShape(.roundedRectangle)”, o que combina com a entrada de New Features que introduz TextInputBorderShape.³

As duras são mais silenciosas do que parecem. O compilador compara a versão de descontinuação com o seu deployment target, não com o SDK, então macos(10.15, 27) só gera aviso em um target cujo macOS mínimo seja 27.0. Rodei o type-check em um arquivo que lê originalFilename, faz um tipo conformar a FileDocument e aplica .roundedBorder, contra o SDK 27.0 com dois targets: com arm64-apple-macos26.0 ele compilou sem diagnóstico nenhum, e com arm64-apple-macos27.0 gerou exatamente um, 'originalFilename' was deprecated in macOS 27: Use filename instead. FileDocument e .roundedBorder ficaram em silêncio nos dois.³ Um app de Mac com um mínimo realista não vai ouvir falar de nenhuma delas pelo compilador; o aviso é o grep do checklist abaixo.

O que há de novo que muda o código que você já tem?

Puxar para atualizar no Mac. “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.” (o AppKit adiciona puxar para atualizar ao NSScrollView: você o define com refreshController, configura um target ou uma ação e chama endRefreshing ao terminar ou beginRefreshing para iniciar por código). A classe e a propriedade refreshController do NSScrollView são ambas API_AVAILABLE(macos(27.0)) no SDK.²³

Seleção de texto por gestos. “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” (oferece as interações comuns de seleção de texto por meio de gesture recognizers em vez de sobrescrever os métodos de mouse, e o NSTextView já o usa) e “Existing NSTextView subclasses that override mouseDown: continue to work through a binary-compatible fallback path.” (subclasses existentes que sobrescrevem mouseDown: continuam funcionando por um caminho de fallback compatível em binário). A classe é macos(27.0).²³ Somado à regra de exclusividade acima, uma text view personalizada que sobrescreve mouseDown: continua funcionando, mas um gesture recognizer que você anexou ao lado dela pode agora ceder a vez aos do gerenciador.

Papéis para abas. NSToolbarItemGroup e NSSegmentedControl ganham uma propriedade role, API_AVAILABLE(macos(27.0)) nos dois, com NSToolbarItemGroup.Role (automatic, tabs, valueSelection) e NSSegmentedControlRole; as notas dizem que um papel tabs é “read by VoiceOver as “tabs”” (lido pelo VoiceOver como abas) com “a distinct visual appearance.” (uma aparência visual própria). O TabsPickerStyle do SwiftUI é a mesma ideia, e os inspectors o adotam automaticamente na recompilação.²³

Hot Corners desligados. “NSApplication.presentationOptions now includes the .disableScreenCornerInteractions option, which you can use to disable Hot Corners.” (inclui essa opção para desligar os Hot Corners). No header ela é NSApplicationPresentationDisableScreenCornerInteractions, API_AVAILABLE(macos(27.0)), o bit 15 da máscara de opções, e o comentário acima dela diz “.autoHideDock or .hideDock must also be set for this option to take effect.” (também é preciso definir .autoHideDock ou .hideDock para a opção ter efeito).²³

Documentos, reescritos. “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,” (os novos protocolos suportam leitura e escrita assíncronas, relato de progresso e acesso direto às URLs dos documentos) com Document combinando os dois e FileDocument e ReferenceFileDocument “now deprecated.” Três entradas derivadas mudam conformidades existentes: a closure makeFileWrapper de FileWrapperDocumentWriter “now receives a second argument, previous: FileWrapper?,” e “Existing call sites must update their closures to accept the new parameter” (os pontos de chamada existentes precisam atualizar as closures para aceitar o novo parâmetro); os requisitos read(from:progress:) e write(content:to:previous:progress:) são “declared with @concurrent instead of nonisolated,” então “Conforming types that previously used nonisolated should switch to @concurrent to match” (tipos que usavam nonisolated devem passar para @concurrent); e URLDocumentConfiguration “no longer conforms to Sendable.” Uma sobrecarga de fileExporter exporta uma coleção de valores WritableDocument em um único diálogo. O problema conhecido da mesma área: o progresso “might not be presented.” (pode não ser exibido).²

Imagens, bordas, sliders, menus. “AsyncImage now automatically caches downloaded images using HTTP caching protocols,” (faz cache automático das imagens baixadas seguindo os protocolos de cache HTTP) com inicializadores de URLRequest e View.asyncImageURLSession(_:) para direcioná-lo. TextInputBorderShape e textInputBorderShape(_:) chegam com o estilo .bordered. “On macOS, the Slider implementation no longer uses NSSlider,” e os botões com borda de Menu e Picker “no longer use NSPopUpButton in their implementation,” então código de desenho personalizado ou de acessibilidade que supunha o controle do AppKit por baixo não tem mais o que encontrar. GeometryProxy ganha concentricCornerRadii e concentricCornerRadii(in:). Os modificadores alert e confirmationDialog com item de dados agora vão até o macOS 12.0.²

StoreKit. “Offer code redemption APIs now return a VerificationResult when redemption completes,” (as APIs de resgate de códigos de oferta retornam um VerificationResult ao concluir) Transaction.OwnershipType.assigned e Transaction.RevocationType.assignmentRevoked “support volume purchases,” (suportam compras por volume) e “Transaction query methods now additionally return transactions assigned to the Managed Apple Account.” (os métodos de consulta de Transaction também retornam transações atribuídas à Managed Apple Account). Product.ProductType ganha Bundles e Suites de assinatura com Product.SubscriptionInfo.BundledSubscription, e partnerName e partnerId chegam às informações de Advanced Commerce. A interface traz assigned e BundledSubscription; o caso de revogação não é escrito do jeito que a nota escreve. Nenhum arquivo do SDK contém assignmentRevoked; a interface do StoreKit declara public static var assignmentRevocation em Transaction.RevocationType, com o valor raw ASSIGNMENT_REVOKE. O caso é @available(macOS 26.4, *) com @backDeployed(before: macOS 27.0), então .assignmentRevocation passa no type-check com target 27.0 e precisa de if #available(macOS 26.4, *) abaixo desse mínimo; o nome da nota não tem membro nenhum para o qual resolver, em target nenhum. Um app de Mac que filtra transações por tipo de propriedade agora vê um terceiro valor.²³

stat em Swift. “System now provides Swift APIs for the C stat, lstat, fstat, and fstatat system calls,” (o System oferece APIs Swift para essas chamadas de sistema em C) com um tipo Stat e FilePath.stat(); as notas também listam como corrigido um conflito em que “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.” (extensões próprias que chamam stat() sem o prefixo Darwin. podem conflitar com os novos métodos de instância). public struct Stat está na interface do System.²³

Imagens de disco, máquinas virtuais, 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.” (o novo framework oferece APIs Swift para criar e gerenciar imagens de disco avulsas e empilhadas em ASIF e em formato raw, para uso com o Virtualization). O framework está no SDK. O encaminhamento de portas do vmnet no Virtualization “now support[s] port forwarding when communicating over loopback,” (agora suporta encaminhamento de portas via loopback) e o spctl ganha um comando purge “which will clean up Gatekeeper database entries for apps and executables which are no longer mounted.” (que limpa as entradas do banco de dados do Gatekeeper de apps e executáveis que não estão mais montados). O post sobre containers é onde as APIs de imagem de disco entram para quem automatiza VMs.²³

Controles de jogo, vídeo, Metal. “The PlayStation® Access™ controller is now supported on macOS, iPadOS, and iOS.” VTLowLatencySuperResolutionScalerConfiguration “now supports a 1.5x scale factor,” e a interpolação de quadros “supports arbitrary source dimensions up to 1080p.” Duas correções do Metal cobrem samplers clamp-to-edge que retornavam zero, uma delas específica de “the Apple 10 GPU family.”²

Foundation. A correção do NSURL aparece aqui com a mesma redação das notas do iOS: “+[NSURL URLWithString:] no longer double-encodes the % of valid percent-escape sequences when encoding other invalid characters.” (não codifica mais duas vezes o % de sequências de escape válidas ao codificar outros caracteres inválidos). No post sobre o iOS mostrei que a correção segue o sistema em que o código roda, e que um build de Mac do mesmo código ainda gerava o resultado antigo %2520 no macOS 26.6.2; espere o resultado novo no 27.0 e o antigo em qualquer 26.x.²

Segurança de hardware. “arm64e.x1 introduces additional hardware security and performance instructions, including CPA2 for stronger MIE protection,” (introduz instruções adicionais de segurança e desempenho, incluindo CPA2 para uma proteção MIE mais forte) em “Mac computers with M6 or later chips”; a lista de targets do stub do DVDPlayback, mais acima, mostra o nome da slice na prática. O post sobre o arm64e.x1 cobre o build setting.²³

Problemas conhecidos para planejar

• Entidades photos.asset param de compilar. “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.” (entidades que conformavam a esse schema podem não compilar nos SDKs 27 porque novas propriedades foram adicionadas). O contorno é adotar as propriedades atrás de uma checagem de disponibilidade; o post sobre as notas do iOS lista as 12 propriedades que o processador de metadados exige, e as notas do macOS trazem a mesma entrada.²
• Schema de áudio e Siri. “If you adopt the Audio App Schema domain, you might have trouble playing your content using Siri.” (se você adotar esse domínio, pode ter problemas para tocar seu conteúdo pela Siri). Contorno: “Adopt an IntentValueQuery that takes the AudioSearch input, or index your entities in Spotlight.” (adote um IntentValueQuery que receba AudioSearch ou indexe suas entidades no Spotlight).²
• SpotlightSearchTool estoura o modelo do dispositivo. Sem uma configuração, “the tool’s description and parameter schema alone exceed the on-device model’s context window before any prompt is added” (só a descrição e o schema de parâmetros já passam da janela de contexto do modelo local antes de qualquer prompt); a solução é um guia focado, como .focused(.documents).²
• Files & Folders para processos sem bundle. Um processo sem bundle ID “cannot be granted access to specific app data containers or app group containers owned by other developer teams,” e o contorno da Apple é Full Disk Access “for the duration of the requirement.” (enquanto durar a necessidade). Ferramentas de linha de comando que leem o container de outro app são o caso.²
• Extensões do Safari sem assinatura. Ao desenvolvê-las, “unsigned extensions might not appear until rebuilt when using the “Allow Unsigned Extensions” checkbox.” (extensões sem assinatura podem não aparecer até serem recompiladas).²
• Testes de StoreKit. “Changing the storefront or locale using SKTestSession doesn’t propagate through Storefront.updates,” (trocar a loja ou a localidade com SKTestSession não se propaga) e compras que falham “might display error dialogs even when dialogsDisabled is set to true.” (podem mostrar diálogos de erro mesmo com os diálogos desativados). As duas aparecem como corrigidas nas notas do beta 2 do 27.2, que acrescentam uma nova: a compra de uma assinatura dentro de um bundle “incorrectly allows the user to unbundle instead of throwing an error.” (permite por engano separá-la do bundle em vez de lançar um erro).²⁴
• Shortcuts. Um intent que usa Duration ou LPLinkMetadata “might fail” (pode falhar) em “Describe a change”, e um parâmetro UnionValue com dois tipos numéricos mostra a opção duas vezes; declare um só.²
• Disco de inicialização a partir do 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.” (com o macOS 11.0, talvez não seja possível escolher o volume do macOS 27.0 como disco de inicialização em System Settings). O contorno é o seletor de inicialização pelo botão liga/desliga.²
• Siri, seis entradas. Seleção de fotos depois de uma busca, “Ask Siri” aparecendo onde a Siri está desligada, falta de comandos de voz para fotos específicas, snippets incompletos do Maps, contagens ao adicionar em álbuns, e imagens de entidades que não são SF Symbols não aparecendo nos resultados da Siri para apps de terceiros. A última é para você checar se as suas entidades têm imagens personalizadas.²

O que eu não consegui rodar

Este Mac roda o macOS 26.6.2, e uma máquina com 27 continua sendo o que eu não tenho. Todo comportamento do sistema neste post é texto da Apple, citado e marcado como tal; nada acima diz que um sistema macOS 27 fez alguma coisa porque eu vi. O que eu consegui rodar foi o SDK: o Xcode 27 (27A266a) traz o SDK do macOS 27.0 (26A425) em qualquer Mac que consiga instalá-lo, então as anotações dos headers, as interfaces Swift, as pastas dos frameworks e as três rodadas de type-check são reais, com data de 26 de setembro. Os dois pontos em que o SDK e as notas discordam, o stub do DVDPlayback e a grafia do caso de revogação, estão relatados como o que o SDK mostra, não como afirmações sobre o que uma máquina com 27 vai fazer em tempo de execução.³

O que eu faria nesta semana

1. Faça um archive no Xcode 27 e passe a lista de mudanças ao vincular com o 27, acima, pelo app antes de notarizar: imagens de itens de menu, qualquer painel de abertura que defina tipos de conteúdo, qualquer código que percorra o menu de contexto do NSTextView, acessórios da barra de título e qualquer sheet que herdava modificadores de controle.²
2. Teste os gestos em uma máquina com 27 antes dos seus usuários: um recognizer em uma view pai que antes disparava junto com o de uma filha agora é exclusivo, e uma subclasse personalizada de NSGestureRecognizer sem locationInView: retorna a origem e registra um erro. Fique de olho no console por esse erro, que a Apple diz que o AppKit gera; o default NSGestureRecognizerCrashOnMissingOverrides é descrito para subclasses que não chegam a um estado terminal, e as notas não dizem que ele cobre locationInView:.²
3. Rode um grep por originalFilename, FileDocument, ReferenceFileDocument, .roundedBorder, deleteEvents e import DVDPlayback; o primeiro só avisa com target 27.0, os três seguintes são brandos e silenciosos, deleteEvents não existe mais, e import DVDPlayback vira erro no dia em que você subir o mínimo para 27.0.³
4. Se você distribui um agent ou daemon por download, remova o atributo de quarentena da property list na instalação, ou instale-a por um caminho que nunca o carregue; as notas da Apple listam o launchd no 27 como não carregando mais esses arquivos.²
5. Se você lê o container de outro time, remova esse código ou passe-o por Full Disk Access; o pedido de permissão acabou e o padrão é negar.²
6. Registre o número do build nos relatórios de bug dos dois lugares: ProcessInfo na máquina e o SystemVersion.plist do SDK no Mac de build. Eles diferem, 26A428 contra 26A425, e uma correção que está em um pode não estar no outro.³

Perguntas frequentes

Quando o macOS 27 saiu, e qual é o build?

Na segunda-feira, 14 de setembro de 2026, como o build 26A428, no feed de lançamentos da Apple junto com o Xcode 27 e os outros sistemas 27.0. O SDK dentro do Xcode 27 se identifica como 26A425.¹³

O macOS 27.0.1 já saiu?

Não até 26 de setembro de 2026. O índice de notas de versão do macOS da Apple lista “macOS 27 Golden Gate Release Notes” e “macOS 27.2 Golden Gate Beta 2 Release Notes” e nada entre eles, e o feed de lançamentos não traz nenhum 27.0.1 para plataforma nenhuma. Este post vai ganhar uma nota datada quando ele sair.¹⁷

Onde estão as notas de versão do macOS 27?

No site de documentação para desenvolvedores da Apple, em macOS Release Notes, em uma página única para a versão, intitulada “macOS 27 Golden Gate Release Notes”, com 86 áreas, General primeiro e depois de Accessory Access a XQuartz. As notas do beta do 27.2 são uma página separada e bem mais curta.²⁴

O que está descontinuado no macOS 27?

Treze entradas sob títulos de Deprecations: PHAssetResource.originalFilename, FileDocument, a renomeação de calendar.deleteEvents, o framework DVDPlayback, Encrypted HFS+, o acesso direto ao banco de dados do TCC, a obrigatoriedade do ciclo de vida por cenas no Catalyst, três entradas de Rosetta, o AirPort Utility em instalações limpas, uma nota de beta do USDKit e uma nota de idioma do Weather Highlights. Só as quatro primeiras são API. originalFilename ganha um aviso só com deployment target 27.0, FileDocument fica em silêncio, deleteEvents não compila e DVDPlayback avisa abaixo de um mínimo de 27.0 e falha com ele.²³

Meu app precisa ser recompilado para o macOS 27?

Não, e é a recompilação que muda parte do comportamento. As entradas de vínculo com o 27 só disparam quando você faz o archive com o SDK 27; as mudanças de gestos, launchd, TCC, containers, TLS e Rosetta valem para todo binário em uma máquina com 27, recompilando ou não, e um app vinculado ao macOS 26.0 ou posterior já perde ali as imagens de símbolo dos menus.²

O DVDPlayback sumiu do SDK?

Não do SDK 27.0 em disco: a pasta do framework, o .tbd, os headers e o module map estão todos presentes no MacOSX27.0.sdk do Xcode 27. As funções dele estão marcadas como indisponíveis com deployment target 27.0 e descontinuadas desde o 10.15 abaixo disso, então um projeto com mínimo 27.0 não consegue compilar contra ele, que é o que a nota diz; um projeto com mínimo mais baixo ainda consegue, com um aviso.³

O que mudou para o Mac Catalyst no macOS 27?

A obrigatoriedade do ciclo de vida por cenas se aplica, UIScene.extendStateRestoration e completeStateRestoration ficam disponíveis ao vincular com o SDK macCatalyst 27, apps Catalyst não criam mais uma janela quando você alterna para eles sem nenhuma aberta, a menos que sejam ativados pelo Dock ou pelo Spotlight, o UIStepper funciona no idioma de Mac, e os botões ausentes da barra de ferramentas da barra lateral aparecem como corrigidos. As notas do beta do Xcode 27.2 acrescentam um alerta: o SDK do macOS de lá “incorrectly report[s] 27.1 as a valid deployment target,” (informa por engano o 27.1 como deployment target válido) e builds de Catalyst em 27.1 ou 27.2 “may be unable to use newly introduced API.” (podem não conseguir usar APIs recém-introduzidas).²⁵

Fontes