Compartilhar via

Atualizando aplicativos existentes para a API Unificada

  • Artigo

Importante

A API Clássica do Xamarin, que precedeu a API Unificada, foi preterida.

  • A última versão do Xamarin.iOS para dar suporte à API Clássica (monotouch.dll) foi o Xamarin.iOS 9.10.
  • O Xamarin.Mac ainda dá suporte à API Clássica, mas não é mais atualizada. Como ele foi preterido, os desenvolvedores devem mover seus aplicativos para a API Unificada.

Como atualizar seus aplicativos

Há três etapas para atualizar seus aplicativos:

  1. Corrija quaisquer avisos do compilador em seu código existente, especialmente aqueles relacionados a APIs preteridas.

  2. Use a Ferramenta de Migração interna para Visual Studio para Mac para atualizar seus arquivos de projeto e namespaces.

  3. Corrija os erros restantes do compilador relacionados aos novos 64 tipos e outras APIs que foram alteradas. Confira estas dicas para obter informações adicionais sobre atualizações manuais que podem ser necessárias.

Há guias específicos disponíveis para cada produto para ajudá-lo a atualizar seus aplicativos para a API Unificada e suporte de 64 bits:

Aplicativos Xamarin.iOS

Os aplicativos Xamarin.iOS existentes podem ser atualizados para a API Unificada usando a ferramenta de migração automatizada criada para Visual Studio para Mac. Algumas correções adicionais podem ser necessárias, conforme explicado nestas instruções e dicas.

Aplicativos Xamarin.Mac

Os aplicativos Xamarin.Mac existentes podem ser atualizados para a API Unificada usando a ferramenta de migração automatizada interna para Visual Studio para Mac. Algumas correções adicionais podem ser necessárias, conforme explicado nestas instruções e dicas.

Aplicativos do Xamarin.Forms

Siga estas instruções para atualizar uma solução Xamarin.Forms existente com um projeto iOS para usar a API Unificada. O suporte à API unificada só está disponível no Xamarin.Forms 1.3 e posterior, portanto, as instruções também explicam como atualizar seu aplicativo Xamarin.Forms para a versão 1.3. Essas dicas podem ajudar a atualizar qualquer código iOS nativo em renderizadores personalizados ou serviços de dependência.

Trabalhando com tipos nativos em aplicativos multiplataforma

Este artigo aborda o uso dos novos tipos nativos de API Unificada do iOS (nint, nuint, nfloat) em um aplicativo multiplataforma em que o código é compartilhado com dispositivos não iOS, como Android ou Windows Phone OSes. Ele fornece insights sobre quando os tipos nativos devem ser usados e fornece várias soluções possíveis para casos em que o novo tipo deve ser usado com código multiplataforma.

Atualizar associações para a API Unificada

Os clientes que criaram associações para Objective-C bibliotecas precisarão atualizar o projeto de associação para refletir as alterações na API subjacente (em que alguns tipos agora serão de 64 bits). Siga estas instruções para atualizar um projeto de associação existente para dar suporte à API Unificada.