Introdução ao desenvolvimento de Android nativo
Nota
Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.
Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Descrever dois recursos principais do Mobile SDK para Android
- Instalar o Mobile SDK para Android
- Criar um aplicativo Android e especificar as opções do aplicativo
- Importar e criar seu aplicativo no Android Studio
Desenvolvimento de Android nativo
O Mobile SDK para Android oferece os recursos e ferramentas necessários para criar aplicativos habilitados para o Salesforce na plataforma móvel mais popular do mundo. Neste módulo, você aprenderá sobre os recursos fundamentais do Android SDK nativo:
- Automação do fluxo de autenticação OAuth2, que facilita a integração do processo ao aplicativo.
- Acesso à API REST do Salesforce, com classes de utilitários que simplificam o acesso.
Vamos começar! Você precisará concluir o projeto Configurar seu ambiente de desenvolvimento do Mobile SDK antes de prosseguir nesta unidade. Se não for o caso, faça um rápido desvio para esse projeto, para garantir que seu ambiente de desenvolvimento está configurado corretamente. Assim que você estiver pronto para avançar, comece por criar um aplicativo simples e nativo para Android. Depois de uma olhada rápida nas engrenagens, você aprimora as partes do desenvolvimento para Android modificando as interações REST e a interface de usuário do aplicativo.
Criar um aplicativo conectado
Importante
O módulo Noções básicas sobre o Salesforce Mobile SDK, que inclui instruções para aplicativos conectados, é um pré-requisito para este módulo. Você não pode concluir o desafio desta unidade sem criar um aplicativo conectado.
Para se conectar ao serviço Salesforce, todos os aplicativos móveis precisam de um aplicativo conectado ao Salesforce. Um aplicativo conectado permite que seu aplicativo se comunique com o Salesforce e acesse APIs do Salesforce de maneira segura.
Depois de criar e salvar seu aplicativo conectado, observe os detalhes.
- Copie os valores de URL da chamada e de Chave do cliente. Use esses valores para configurar a autenticação do seu aplicativo.
- Os aplicativos do Mobile SDK não utilizam o segredo do cliente, de forma que você pode ignorar esse valor.
Como criar um projeto Android
Agora que você já configurou seu ambiente de desenvolvimento do Android e criou um aplicativo conectado ao Salesforce, está pronto para criar seu primeiro aplicativo forcedroid.
- No prompt de comando, altere para o diretório em que deseja armazenar seu projeto e digite:
forcedroid create
- Conforme o forcedroid for solicitando, digite os seguintes valores:
- Tipo de aplicativo: native
- Nome do aplicativo: MyTrailNative
- Nome do pacote: com.mytrail.android
- Nome da organização: MyApps, Inc.
- Diretório de saída: TrailAndroidApps
Depois da sequência de mensagens de registro, uma mensagem de parabéns aparecerá e você voltará ao prompt de comando. Parabéns! Seu novo aplicativo está pronto para ser executado.
Como executar seu novo aplicativo Android
O projeto criado pelo forcedroid está pronto para ser executado imediatamente. Ele não faz muita coisa. Apenas executa uma consulta SOQL simples e exibe uma tabela de nomes. Mas, pelo menos, você sabe que tudo está no lugar devido e pronta para atender ao seu comando. Vamos ver com funciona na prática!
Ao criar um aplicativo nativo, o forcedroid substitui valores genéricos pela ID do consumidor e pelo URI do retorno de chamada. Cada aplicativo requer esses valores para se conectar aos servidores e dados do Salesforce. Antes de lançar o aplicativo publicamente, lembre-se de substituir a configuração genérica por valores de seu próprio aplicativo conectado. Para não se esquecer, vamos fazer isso agora.
- No diretório do projeto, abra app\res\values\bootconfig.xml em um editor de texto compatível com UTF-8. (Dica do Windows: A codificação ANSI padrão de fábrica do notepad.exe não vai funcionar. No entanto, você pode usar a caixa de diálogo Salvar como do Bloco de Notas para escolher a codificação UTF-8.)
- Substitua o valor remoteAccessConsumerKey pela chave do cliente do seu aplicativo conectado.
- Substitua o valor oauthRedirectURI pela URL de retorno de chamada do seu aplicativo conectado.
- Salve o arquivo em codificação UTF-8.
Pronto! Você criou e personalizou com sucesso um aplicativo Android nativo que usa o Mobile SDK. É hora de criá-lo e executá-lo com o Android Studio.
- Inicie o Android Studio.
- Na tela de boas-vindas, selecione Importar projeto (Eclipse ADT, Gradle, etc.). Ou, se o Android Studio já estiver em execução, selecione .
- Navegue até o diretório de destino, TrailAndroidApps, e clique em OK.
O Android Studio cria seu espaço de trabalho automaticamente. Esse processo pode durar vários minutos. Quando a barra de status informar “Gradle build successful” (Criação do Gradle bem-sucedida), você estará pronto para executar o projeto.
- Clique em , (Executar | Executar aplicativo) ou pressione SHIFT+F10 (Windows) ou ^R (Mac).
- Selecione um emulador ou um dispositivo conectado que esteja executando o Android SDK API 23 ou uma versão posterior (até Android 10 (API 29)).
O Android Studio inicia seu aplicativo no emulador ou no dispositivo Android conectado.