Para instrumentar um aplicativo iOS, é necessário executar o script rtwBuildXcode.sh
com os parâmetros apropriados. Também é possível enviar por push o aplicativo
instrumentado para o test workbench e
o instalar em um dispositivo iOS, o iOS Simulator, ou ambos, usando o
mesmo script de construção.
Nota: Antes de usar os shell scripts, certifique-se de que você tem
permissão para executar shell scripts. Se necessário, use chmod para
atualizar as suas permissões.
O script rtwBuildXcode.sh fornece
suporte para os projetos e área de trabalho do Xcode. Uma área de trabalho do Xcode
permite agrupar vários projetos do Xcode e outros arquivos para
tornar mais fácil trabalhar com eles juntos.
Para executar o script,
insira uma das linhas de comandos a seguir em seu terminal Macintosh
com os parâmetros adaptados para o seu contexto de trabalho.
unpack_dir/build-script/rtwBuildXcode.sh app.xcodeproj Workbench URL simu|device|both
unpack_dir/build-script/rtwBuildXcode.sh app.xcworkspace scheme Workbench URL simu|device|both
Em que:
- unpack_dir é o diretório no qual você extraiu
o archive transferido por download.
- app.xcodeproj é o caminho absoluto ou relativo
para o .xcodeproj criado para o aplicativo em teste. Se o nome
ou o caminho para o arquivo Xcodeproj contiver espaços, coloque o caminho
completo entre aspas duplas (" “) ou substitua todos os espaços por barras invertidas
(\).
- app.xcworkspace é o caminho absoluto ou relativo
para o .xcworkspace que inclui o .xcodeproj para o aplicativo
em teste. Se o nome ou o caminho contiver espaços, coloque o caminho
completo entre aspas duplas (" “) ou substitua todos os espaços por barras invertidas
(\). Para obter detalhes, consulte a documentação do Apple Developer em Área de trabalho do Xcode.
- scheme é uma coleta de configurações do Xcode que
inclui destinos de construção do projeto, uma configuração de construção e o ambiente
executável para executar o produto. Para obter detalhes, consulte a documentação do Developer
Apple em Esquemas do Xcode.
- Workbench URL indica a URL do Workbench copiada
a partir do editor Dispositivo móvel. A inclusão da
URL do Workbench é altamente recomendada, pois esta é a maneira mais fácil
de registrar um aplicativo para o test workbench. O test workbench precisará conhecer o
aplicativo quando ele receber o log de gravação para produzir
um teste completo. Em um contexto no qual a URL do Workbench é usada a partir
do shell script rtwBuildXcode.sh, não inclua mobile no
final da URL do Workbench. Como um exemplo, indique somente http://<ip-address>:7878.
Nota: Se
você especificar a URL do Workbench na linha de comandos, o aplicativo
instrumentado será automaticamente enviado por push para o test workbench. Se você não
especificar a URL do Workbench na linha de comandos, será possível incluir o aplicativo
em teste no test workbench
clicando em Incluir aplicativos na lista no editor Aplicativos
móveis.
- simu|device|both são parâmetros opcionais para indicar
que você deseja fazer upload do aplicativo instrumentado para os iOS Simulators
no computador Macintosh, para um dispositivo iOS, ou para ambos. Os Simuladores
serão reiniciados automaticamente para usar esse novo aplicativo. Para fazer
upload para um dispositivo, ele deve ser conectado ao Mac por meio de USB.