Tutorial 5 - Levando para o Mobile: iOS

Para compilar aplicativos iOS, precisaremos do Xcode, que está disponível gratuitamente na macOS App Store. Quando o Xcode estiver instalado, inicie-o em Aplicativos e aceite o Contrato de Licença do Xcode. Em seguida, o Xcode mostrará quais componentes estão incorporados e quais componentes você pode baixar. Marque a caixa de seleção ao lado do iOS (seguido do número da versão atual) e clique em "Download and Install" para instalá-lo. O Xcode instalará os componentes do sistema, seguidos pelo Simulador do iOS.

Depois de instalar o Xcode, podemos pegar nosso aplicativo e implantá-lo como um aplicativo iOS.

O processo de implantação de um aplicativo no iOS é muito semelhante ao processo de implantação como um aplicativo de desktop. Primeiro, você executa o comando create, mas, desta vez, especificamos que queremos criar um aplicativo iOS:

(beeware-venv) $ briefcase create iOS

[helloworld] Gerando modelo de aplicativo...
Usando modelo de aplicativo: https://github.com/beeware/briefcase-iOS-Xcode-template.git, ramificação v0.3.18
...

[helloworld] Instalando pacote de suporte...
...

[helloworld] Instalando código do aplicativo...
Instalando src/helloworld... concluído

[helloworld] Instalando requisitos...
...

[helloworld] Instalando recursos do aplicativo...
...

[helloworld] Removendo conteúdo desnecessário do aplicativo...
...

[helloworld] Criado build/helloworld/ios/xcode

Quando isso for concluído, teremos um diretório build/helloworld/ios/xcode contendo um projeto Xcode, bem como as bibliotecas de suporte e o código do aplicativo necessários para o aplicativo.

Em seguida, você pode usar o Briefcase para compilar o aplicativo usando briefcase build iOS:

(beeware-venv) $ briefcase build iOS

[helloworld] Atualizando metadados do aplicativo...
Definindo o módulo principal... concluído

[helloworld] Compilando projeto do Xcode...
...
Compilando... concluído

[helloworld] Compilado em build/helloworld/ios/xcode/build/Debug-iphonesimulator/Hello World.app

Agora estamos prontos para executar nosso aplicativo, usando o briefcase run iOS. Será solicitado que você selecione um dispositivo para o qual compilar; se você tiver simuladores para várias versões do SDK do iOS instalados, também poderá ser perguntado qual versão do iOS deseja usar como alvo. As opções mostradas a você podem ser diferentes das opções mostradas nesta saída - no mínimo, a lista de dispositivos provavelmente será diferente. Para nossos propósitos, não importa qual simulador você escolherá.

(beeware-venv) $ briefcase run iOS

Selecione o dispositivo do simulador:

   1) iPad (10ª geração)
   2) iPad Air (5ª geração)
   3) iPad Pro (11 polegadas) (4ª geração)
   4) iPad Pro (12,9 polegadas) (6ª geração)
   5) iPad mini (6ª geração)
   6) iPhone 14
   7) iPhone 14 Plus
   8) iPhone 14 Pro
   9) iPhone 14 Pro Max
   10) iPhone SE (3ª geração)

>  10

No futuro, você poderá especificar este dispositivo executando:

 $ briefcase run iOS -d "iPhone SE (3ª geração)::iOS 16.2"

ou:

 $ briefcase run iOS -d 2614A2DD-574F-4C1F-9F1E-478F32DE282E

[helloworld] Iniciando o aplicativo em um iPhone SE (3ª geração) com iOS 16.2 (UDID do dispositivo 2614A2DD-574F-4C1F-9F1E-478F32DE282E)
Inicializando o simulador... concluído
Abrindo o simulador... concluído

[helloworld] Instalando o aplicativo...
Desinstalando qualquer versão existente do aplicativo... concluído
Instalando nova versão do aplicativo... concluído

[helloworld] Iniciando o aplicativo...
Iniciando o aplicativo... concluído

[helloworld] Saída do log do simulador a seguir (digite CTRL-C para interromper o log)...
===========================================================================
...

Isso iniciará o simulador do iOS, instalará seu aplicativo e o iniciará. Você deverá ver o simulador iniciar e, por fim, abrir seu aplicativo iOS:

Enquanto o aplicativo estiver em execução, você verá uma série de mensagens de saída de log do Simulador no console. Digitar Ctrl+C no terminal interromperá as mensagens no console, mas não fechará o simulador. Isso serve para que você possa testar novas alterações sem reiniciar o simulador.

Se você souber antecipadamente qual simulador de iOS deseja usar, poderá dizer ao Briefcase para usar esse simulador fornecendo uma opção -d (ou --device). Usando o nome do dispositivo que você selecionou ao criar o aplicativo, execute:

$ briefcase run iOS -d "iPhone SE (3ª geração)"

Se você tiver várias versões do iOS disponíveis, o Briefcase escolherá a versão mais alta do iOS; se você quiser escolher uma versão específica do iOS, diga a ele para usar essa versão específica:

$ briefcase run iOS -d "iPhone SE (3ª geração)::iOS 15.5"

Ou você pode nomear um UDID de dispositivo específico:

$ briefcase run iOS -d 2614A2DD-574F-4C1F-9F1E-478F32DE282E

Próximos passos

Agora temos um aplicativo em nosso telefone! Existe algum outro lugar onde possamos implantar um aplicativo BeeWare? Consulte o Tutorial 6 para descobrir…