Criar uma aplicação iOS (Pré-visualização)

  • Artigo

Este artigo mostra como adicionar o Azure Maps a um aplicativo iOS. Ele orienta você através destas etapas básicas:

  • Configure seu ambiente de desenvolvimento.
  • Crie sua própria conta do Azure Maps.
  • Obtenha sua chave principal do Azure Maps para usar no aplicativo.
  • Faça referência às bibliotecas do Azure Maps do projeto.
  • Adicione um controle do Azure Maps ao aplicativo.

Nota

Aposentadoria do SDK do iOS do Azure Maps

O SDK nativo do Azure Maps para iOS foi preterido e será desativado em 31/03/25. Para evitar interrupções de serviço, migre para o SDK da Web do Azure Maps até 31/03/25. Para obter mais informações, consulte O guia de migração do SDK do iOS do Azure Maps.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Nota

Para obter mais informações sobre autenticação no Azure Maps, consulte gerenciar autenticação no Azure Maps.

Criar uma conta do Azure Maps

Crie uma nova conta do Azure Maps com as seguintes etapas:

  1. No canto superior esquerdo do portal do Azure, selecione Criar um recurso.

  2. Na caixa Pesquisar no Marketplace, digite Azure Maps.

  3. Nos Resultados, selecione Azure Maps e, em seguida, selecione o botão Criar que aparece abaixo do mapa.

  4. Na página Criar Conta do Maps, introduza os seguintes valores:

    • A Subscrição que quer utilizar para esta conta.
    • O nome do Grupo de recursos para esta conta. Pode optar por Criar um grupo de recursos novo ou Utilizar um grupo de recursos existente.
    • O Nome da nova conta.
    • O nível de preço para esta conta.
    • Leia a Licença e a Declaração de Privacidade, e selecione a caixa de verificação para aceitar os termos.
    • Selecione o botão Criar.

    Crie uma conta de mapas do Azure.

Obter a chave de subscrição da sua conta

Assim que a sua conta do Google Maps for criada com êxito, recupere a chave primária que lhe permite consultar as APIs do Google Maps.

  1. Abra a sua conta do Maps no portal.

  2. Na seção de configurações, selecione Autenticação.

  3. Copie a Chave primária para a área de transferência. Guarde-a localmente para a utilizar mais tarde neste tutorial.

Nota

Este guia de início rápido usa a autenticação de chave compartilhada para fins de demonstração, mas a abordagem preferida para qualquer ambiente de produção é usar a autenticação do Microsoft Entra.

Captura de ecrã a mostrar a sua chave de subscrição do Azure Maps no portal do Azure.

Criar um projeto no Xcode

Primeiro, crie um novo projeto de aplicativo iOS. Conclua estas etapas para criar um projeto Xcode:

  1. Em Arquivo, selecione Novo ->Projeto.

  2. No separador iOS, selecione Aplicação e, em seguida, Seguinte.

  3. Introduza o nome da aplicação, o ID do pacote e, em seguida, selecione Seguinte.

Consulte Criando um projeto Xcode para um aplicativo para obter mais ajuda com a criação de um novo projeto.

Crie a primeira aplicação iOS.

Instalar o SDK do iOS do Azure Maps

A próxima etapa na criação do seu aplicativo é instalar o SDK do iOS do Azure Maps. Conclua estas etapas para instalar o SDK:

  1. Com o projeto Xcode iOS desejado selecionado no Navegador de projetos, selecione o botão Adicionar dependência de + pacote.

    Adicionar dependência de pacote.

  2. Insira os seguintes valores na caixa de diálogo resultante:

    • Entre https://github.com/Azure/azure-maps-ios-sdk-distribution.git na barra de pesquisa que aparece no canto superior direito.
    • Selecione Up to Next Major Version no campo Regra de dependência .
    • Entre 1.0.0-pre.3 no campo Versão da Regra de Dependência .

    Adicione uma regra de dependência a um projeto iOS.

  3. Depois que o pacote juntamente com suas dependências estiver resolvido, selecione o botão Adicionar pacote para concluir a configuração da dependência.

    Adicionar pacote a um projeto iOS.

Adicionar vista MapControl

  1. Adicionar personalizado UIView para exibir o controlador

  2. Selecionar MapControl classe do AzureMapsControl módulo

    Adicione um controle de mapas do Azure.

  3. No arquivo AppDelegate.swift:

    • adicionar importação para o SDK do Azure Maps
    • definir suas informações de autenticação do Azure Maps

Ao definir as informações de autenticação na classe AzureMaps globalmente usando o AzureMaps.configure(subscriptionKey:) ou AzureMaps.configure(aadClient:aadAppId:aadTenant:), você não precisa adicionar suas informações de autenticação em todas as exibições.

  1. Selecione o botão executar, conforme mostrado no gráfico a seguir (ou pressione CMD + R), para criar seu aplicativo.

    Execute o aplicativo iOS.

Xcode leva alguns segundos para construir o aplicativo. Após a conclusão da compilação, você pode testar seu aplicativo no dispositivo iOS simulado. Você deve ver um mapa como este:

O seu primeiro mapa numa aplicação iOS.

Funcionalidade de mapa de acesso

Você pode começar a personalizar a funcionalidade do mapa segurando a AzureMap instância em um mapView.onReady manipulador. Depois que o MapControl modo de exibição for adicionado, seu exemplo ViewController deverá ser semelhante ao código a seguir:

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let mapView = self.view.subviews.first as? MapControl;
        mapView?.onReady({ map in
            // customize your map here
            // map.sources.add()
            // map.layers.insertLayer()
        })
    }
}

Prossiga para Adicionar uma camada de polígono ao mapa no SDK do iOS para obter um desses exemplos.

Clean up resources (Limpar recursos)

Siga estas etapas para limpar os recursos criados neste guia de início rápido:

  1. Feche o Xcode e exclua o projeto que você criou.

  2. Se você testou o aplicativo em um dispositivo externo, desinstale o aplicativo desse dispositivo.

Se você não planeja continuar a desenvolver com o SDK do iOS do Azure Maps:

  1. Navegue até a página do portal do Azure. Selecione Todos os recursos na página principal do portal. Ou selecione o ícone de menu no canto superior esquerdo e, em seguida , Todos os recursos.

  2. Selecione sua conta do Azure Maps. Na parte superior da página, selecione Eliminar.

  3. Opcionalmente, se você não planeja continuar desenvolvendo aplicativos iOS, desinstale o Xcode.

Informações adicionais

Consulte os seguintes artigos para obter mais exemplos de código: