Demonstração de ponta a ponta do Xamarin

improve this page | report issue

Visão Geral

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

  1. Um aplicativo de amostra que é empacotado com o SDK do cliente MobileFirst Xamarin é registrado com o 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.

Pré-requisitos:

  • Xamarin Studio
  • 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.mfpstarterxamarin como o identificador do aplicativo (dependendo da andaime do aplicativo do qual você fará download na próxima etapa)
    • Insira 1.0 como o valor da versão
    • Clique em Registrar aplicativo

    Registre um aplicativo

3. Editando a lógica de aplicativo

  • Crie um projeto Xamarin.
  • Inclua o Xamarin SDK conforme mencionado no tutorial Incluindo o SDK.
  • Inclua uma propriedade do tipo IWorklightClient em qualquer arquivo de classe, conforme abaixo.

     /// <summary>
     /// Obtém ou configura o cliente de amostra worklight.
     /// </summary>
     /// <value>O cliente worklight.</value>
     public static IWorklightClient WorklightClient {get; set;}
    
  • Se estiver desenvolvendo para iOS, cole o código a seguir no método FinishedLaunching do arquivo AppDelegate.cs:

     <ClassName>.WorklightClient = WorklightClient.CreateInstance();
    

    Substitua <ClassName> pelo nome de sua classe.

  • Se estiver desenvolvendo para Android, inclua a linha de código a seguir no método OnCreate do arquivo MainActivity.cs:

     <ClassName>.WorklightClient = WorklightClient.CreateInstance(this);
    

    Substitua <ClassName> pelo nome de sua classe.

  • Defina um método para obter o token de acesso e execute uma solicitação de recurso para o MFP Server, conforme abaixo.

      public async void ObtainToken()
             {
              try
                     {
    
                         IWorklightClient _newClient = App.WorklightClient;
                         WorklightAccessToken accessToken = await _newClient.AuthorizationManager.ObtainAccessToken("");
    
                         if (accessToken.Value != null &&  accessToken.Value != "")
                         {
                             System.Diagnostics.Debug.WriteLine("Received the following access token value: " + accessToken.Value);
                             StringBuilder uriBuilder = new StringBuilder().Append("/adapters/javaAdapter/resource/greet");
    
                             WorklightResourceRequest request = _newClient.ResourceRequest(new Uri(uriBuilder.ToString(), UriKind.Relative), "GET");
                             request.SetQueryParameter("name", "world");
                             WorklightResponse response = await request.Send();
    
                             System.Diagnostics.Debug.WriteLine("Success: " + response.ResponseText);
    
              }
                     }
          catch (Exception e)
          {
                         System.Diagnostics.Debug.WriteLine("An error occurred: '{0}'", e);
                     }
                 }
             }
      }
    
  • Chame o método ObtainToken em um construtor de classe ou clicando em um botão.

4. Implemente um adaptador

Faça 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 ao lado de Adaptadores.

  1. Selecione a opção Ações Fazer download de amostra. Faça download da amostra de adaptador Java “Hello World”.

    Se o Maven e MobileFirst CLI não estiverem instalados, siga as instruções Configure seu ambiente de desenvolvimento na tela.

  2. Em uma janela Command-line, navegue até 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.

    Implementar um adaptador

5. Testando o aplicativo

  1. No Xamarin Studio, selecione o arquivo mfpclient.properties e edite as propriedades protocol, host e port com os valores corretos para o seu MobileFirst Server.
    • Se usar um MobileFirst Server local, os valores normalmente são http, localhost e 9080.
    • Se usar um MobileFirst Server remoto (no Bluemix), os valores normalmente são https, your-server-address e 443.
  2. Pressione o botão Reproduzir.


Resultados

  • Ao clicar no botão Realizar ping no servidor MobileFirst, Conectado ao servidor MobileFirst será exibido.
  • 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 é então impressa no Xamarin Studio Console.

Imagem do aplicativo que chamou com sucesso um recurso do MobileFirst Server

Próximas etapas

Saiba mais sobre como usar adaptadores em aplicativos e como integrar serviços adicionais, como Notificações Push, usando a estrutura de segurançaMobileFirst e mais:

Last modified on October 05, 2017