Demonstração de ponta a ponta do Android
improve this page | report issueVisão Geral
O propósito desta demonstração é experimentar um fluxo de ponta a ponta:
- Um aplicativo de amostra que é pré-empacotado com o SDK do cliente MobileFirst é registrado e transferido por download a partir do MobileFirst Operations Console.
- Um adaptador novo ou fornecido é implementado no MobileFirst Operations Console.
- A lógica de aplicativo é alterada para fazer uma solicitação de recurso.
Resultado final:
- Ping de MobileFirst Server executado com sucesso.
- Recuperação de dados usando adaptador realizada com sucesso.
Pré-requisitos:
- Android Studio
- Opcional. MobileFirst CLI (download)
- Opcional. Independente MobileFirst Server (download)
1. Iniciando o MobileFirst Server
Certifique-se de ter criado uma instância do Mobile Foundation ou
Se estiver usando MobileFirst Developer Kit, navegue para a pasta do servidor e execute o comando: ./run.sh
em Mac e Linux ou run.cmd
no Windows.
2. Criando um aplicativo
Em uma janela do navegador, abra MobileFirst Operations Console carregando a URL: http://your-server-host:server-port/mfpconsole
. Se estiver executando localmente, use: http://localhost:9080/mfpconsole. O nome de usuário/senha são admin/admin.
- Clique no botão Novo próximo de Aplicativos
- Selecione a plataforma Android
- Insira com.ibm.mfpstarterandroid como o identificador do aplicativo
- Insira 1.0 como o valor da versão
- Clique em Registrar aplicativo
-
Clique no quadro Obter Código de Início e selecione para fazer download do aplicativo de amostra Android.
3. Editando a lógica de aplicativo
-
Abra o projeto Android Studio e importe-o.
-
No menu da barra lateral Projeto, selecione o arquivo app → java → com.ibm.mfpstarterandroid → ServerConnectActivity.java e:
-
Inclua as importações a seguir:
import java.net.URI; import java.net.URISyntaxException; import android.util.Log;
-
Cole o fragmento de código a seguir, substituindo a chamada para
WLAuthorizationManager.getInstance().obtainAccessToken
:WLAuthorizationManager.getInstance().obtainAccessToken("", new WLAccessTokenListener() { @Override public void onSuccess(AccessToken token) { System.out.println("Received the following access token value: " + token); runOnUiThread(new Runnable() { @Override public void run() { titleLabel.setText("Yay!"); connectionStatusLabel.setText("Connected to MobileFirst Server"); } }); URI adapterPath = null; try { adapterPath = new URI("/adapters/javaAdapter/resource/greet"); } catch (URISyntaxException e) { e.printStackTrace(); } WLResourceRequest request = new WLResourceRequest(adapterPath, WLResourceRequest.GET); request.setQueryParameter("name","world"); request.send(new WLResponseListener() { @Override public void onSuccess(WLResponse wlResponse) { // Imprimirá "Hello world" em LogCat. Log.i("MobileFirst Quick Start", "Success: " + wlResponse.getResponseText()); } @Override public void onFailure(WLFailResponse wlFailResponse) { Log.i("MobileFirst Quick Start", "Failure: " + wlFailResponse.getErrorMsg()); } }); } @Override public void onFailure(WLFailResponse wlFailResponse) { System.out.println("Did not receive an access token from server: " + wlFailResponse.getErrorMsg()); runOnUiThread(new Runnable() { @Override public void run() { titleLabel.setText("Bummer..."); connectionStatusLabel.setText("Failed to connect to MobileFirst Server"); } }); } });
4. Implemente um adaptador
Faça o download deste artefato .adapter preparado e implemente-o a partir do MobileFirst Operations Console usando a ação Ações → Implementar Adaptador.
Como alternativa, clique no botão Novo próximo de Adaptadores.
-
Selecione a opção Ações → Download de Amostra. Faça o download da amostra do adaptador Java “Hello World”.
Se o Maven e o MobileFirst CLI não estiverem instalados, siga as instruções Configure seu ambiente de desenvolvimento na tela.
-
Em uma janela de Linha de Comandos, navegue para a pasta raiz do projeto Maven do adaptador e execute o comando:
mfpdev adapter build
-
Quando a compilação for concluída, implemente-a a partir do MobileFirst Operations Console usando a ação Ações → Implementar Adaptador. O adaptador pode ser localizado na pasta [adapter]/target.
5. Testando o aplicativo
- No Android Studio, no menu da barra lateral Projeto, selecione o arquivo app → src → main →assets → mfpclient.properties e edite as propriedades protocol, host e port com os valores corretos para seu MobileFirst Server.
- Se estiver usando um MobileFirst Server local, os valores normalmente serão http, localhost e 9080.
- Se você estiver usando um MobileFirst Server remoto (no IBM Cloud), normalmente os valores serão https, your-server-address e 443.
- Se você estiver usando um cluster do Kubernetes no IBM Cloud Private, e se a implementação for do tipo NodePort, normalmente o valor da porta será NodePort, exposto pelo serviço no cluster do Kubernetes.
Como alternativa, se você tiver instalado MobileFirst CLI, navegue para a pasta raiz do projeto e execute o comando
mfpdev app register
. Se um MobileFirst Server remoto for usado, execute o comandomfpdev server add
para incluir o servidor, seguido por, por exemplo:mfpdev app register myIBMCloudServer
. - Clique no botão Executar Aplicativo.
Resultados
- Um clique no botão Ping MobileFirst Server exibirá Conectado ao MobileFirst Server.
- Se o aplicativo foi capaz de se conectar ao MobileFirst Server, uma chamada de solicitação de recurso usando o adaptador Java implementado acontecerá.
A resposta do adaptador será impressa na visualização LogCat do Android Studio.
Etapas Seguintes
Saiba mais sobre como usar adaptadores em aplicativos e como integrar serviços adicionais, como Notificações Push, usando a estrutura de segurança do MobileFirst e mais:
- Revise os tutoriais Desenvolvendo Aplicativos
- Revise os tutoriais Desenvolvimento de Adaptadores
- Revise os tutoriais Autenticação e Segurança
- Revise os tutoriais Notificações
- Revise Todos os Tutoriais