Compartilhar via

Criar um aplicativo iOS (versão prévia)

  • Artigo

Este artigo mostra como adicionar o Azure Mapas a um aplicativo iOS. Ele apresenta e explica as seguintes etapas básicas:

  • Configurar seu ambiente de desenvolvimento.
  • Criar sua conta do Azure Mapas.
  • Obter a chave primária do Azure Mapas para usar no aplicativo.
  • Referenciar as bibliotecas do Azure Mapas no projeto.
  • Adicionar um controle do Azure Mapas ao aplicativo.

Observação

Desativação do SDK do iOS no Azure Mapas

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

Pré-requisitos

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

Observação

Para obter mais informações sobre a autenticação nos Azure Mapas, confira Gerenciar a autenticação nos Azure Mapas.

Criar uma conta dos Mapas do Azure

Crie uma conta do Azure Mapas seguindo as etapas abaixo:

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

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

  3. Em Resultados, selecione Azure Mapas e selecione o botão Criar que aparece abaixo do mapa.

  4. Na página Criar Conta dos Mapas, insira os seguintes valores:

    • A Assinatura que você deseja usar para a conta.
    • O nome do Grupo de recursos para a conta. Você pode optar por Criar novo ou Usar existente em relação ao grupo de recursos.
    • O Nome da sua nova conta.
    • A Camada de preços para essa conta.
    • Leia a Política de Privacidade e de Licença e marque a caixa de seleção para aceitar os termos.
    • Selecione o botão Criar.

    Crie uma conta do Azure Mapas.

Obter a chave de assinatura para sua conta

Depois de criar com êxito sua conta dos Mapas, recupere a chave primária que permite consultar as APIs dos Mapas.

  1. Abra a sua conta dos Mapas no portal.

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

  3. Copie a Chave Primária para sua área de transferência. Salve-a localmente para usar depois neste tutorial.

Observação

Este guia de início rápido usa a Autenticação de Chave Compartilhada para fins de demonstração, mas a abordagem preferencial para qualquer ambiente de produção é usar a Autenticação do Microsoft Entra.

Captura de tela que mostra sua chave de assinatura do Azure Mapas no portal do Azure.

Criar um projeto no Xcode

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

  1. Em Arquivo, selecione Novo ->Projeto.

  2. Na guia iOS, selecione Aplicativo e Avançar.

  3. Insira o nome do aplicativo, a ID do pacote e selecione Avançar.

Confira Criar um projeto do Xcode para um aplicativo para obter mais ajuda com a criação de um novo projeto.

Criar o primeiro aplicativo iOS.

Instalar o SDK do iOS do Azure Mapas

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

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

    Adicione a dependência de pacote.

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

    • Insira 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.
    • Insira 1.0.0-pre.3 no campo de versão da Regra de Dependência.

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

  3. Depois que o pacote e as respectivas dependências forem resolvidos, selecione o botão Adicionar Pacote para concluir a configuração de dependência.

    Adicione o pacote a um projeto do iOS.

Adicionar a exibição de MapControl

  1. Adicionar a UIView personalizada para controlador de exibição

  2. Selecionar uma classe MapControl no módulo AzureMapsControl

    Adicione um controle de mapa do Azure.

  3. No arquivo AppDelegate.swift:

    • adicionar a importação do SDK do Azure Mapas
    • definir as informações de autenticação do Azure Mapas

Ao definir as informações de autenticação na classe AzureMaps globalmente usando 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 compilar o aplicativo.

    Execute o aplicativo iOS.

O Xcode levará alguns segundos para compilar o aplicativo. Após concluir a compilação do aplicativo, você poderá testá-lo no dispositivo iOS emulado. Você verá um mapa semelhante a esse:

Seu primeiro mapa em um aplicativo iOS.

Funcionalidade do mapa de acesso

Você pode começar a personalizar a funcionalidade do mapa mantendo a instância AzureMap em um manipulador mapView.onReady. Depois que a exibição MapControl for adicionada, 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.

Limpar os recursos

Realize 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 desse dispositivo.

Se você não planejar continuar a desenvolver com o SDK do iOS do Azure Mapas:

  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 Todos os recursos.

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

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

Informações adicionais

Confira os seguintes artigos para obter exemplos de código completo: