Demonstração de ponta a ponta do Android

Visão Geral

O propósito desta demonstração é experimentar um fluxo de ponta a ponta:

1. Um aplicativo de amostra que é pré-empacotado com o SDK do cliente MobileFirst é registrado e transferido por download a partir do MobileFirst Operations Console.
2. Um adaptador novo ou fornecido é implementado no MobileFirst Operations Console.
3. 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.

1. 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

   

2. 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

1. Abra o projeto Android Studio e importe-o.

2. 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.

1. 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.

2. Em uma janela de Linha de Comandos, navegue para a pasta raiz do projeto Maven do adaptador e execute o comando:

   mfpdev adapter build
   

3. 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

1. 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 comando mfpdev server add para incluir o servidor, seguido por, por exemplo: mfpdev app register myIBMCloudServer.

2. 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