Este tópico descreve como integrar o componente MSS a um cliente Android.
|
Nota
Desde 28 de junho de 2020, o mPaaS não mantém mais a baseline 10.1.32. Use a baseline 10.1.68 ou 10.1.60. Para atualizar sua versão de baseline, consulte o Guia de atualização do mPaaS 10.1.68 ou o Guia de atualização do mPaaS 10.1.60. |
O componente MSS oferece dois métodos de integração: integração nativa baseada em AAR e integração baseada em componentes.
A integração envolve duas etapas:
Pré-requisitos
O projeto já deve estar integrado ao mPaaS.
Para integração nativa baseada em AAR, adicione o mPaaS ao seu projeto.
Para integração baseada em componentes, conclua o processo de integração baseada em componentes.
Adicionar o SDK
Integração nativa baseada em AAR
Use o Component Management (AAR) para instale o componente SYNC no projeto. Para mais informações, consulte Gerenciamento de componentes AAR.
Integração baseada em componentes
Nos projetos Portal e Bundle, use o Component Management para instale o componente SYNC.
Para mais informações, consulte Gerenciar dependências de componentes > Adicionar ou remover dependências de componentes.
Usar o SDK
Nas baselines 10.1.32 e posteriores, a classe MPSync na camada de middleware do mPaaS encapsula todas as APIs do MSS. Use o objeto MPSync para acessar todos os recursos do MSS.
A tabela a seguir lista as APIs do MSS. Para obter detalhes, consulte a Referência de API para Android.
|
API |
Descrição |
|
setup(Application application) |
Inicializa os serviços básicos dos quais o MSS depende. Chame este método antes de |
|
initialize(Context context) |
Inicializa a API e o serviço MSS. |
|
appToForeground() |
Notifica o SDK cliente que o aplicativo foi iniciado para estabelecer uma conexão de rede com o servidor. Chame este método sempre que o aplicativo for trazido para o primeiro plano. |
|
appToBackground() |
Notifica o SDK cliente que o aplicativo foi enviado para o segundo plano para desconectar do servidor. Chame este método sempre que o aplicativo for enviado para o segundo plano. |
|
updateUserInfo(String sessionId) |
Atualiza as informações de login quando userId ou sessionId mudam. Chame este método pelo menos uma vez. |
|
clearUserInfo() |
Faz logout do usuário. |
|
registerBiz(String bizType, ISyncCallback syncCallback) |
Registra um |
|
unregisterBiz(String bizType) |
Cancela o registro da configuração de sincronização especificada. Após o cancelamento, o SDK deixa de invocar a classe de implementação |
|
reportMsgReceived(SyncMessage syncMessag) |
Confirma o recebimento de dados da implementação |
|
isConnected() |
Verifica se o serviço MSS está funcionando conforme esperado. |
Exemplo de código
Este exemplo usa o SDK da baseline 10.1.32. Um botão obtém o ID do dispositivo ao ser tocado, e o console usa esse ID para enviar dados de sincronização via push para o dispositivo. O identificador de sincronização é bizType.
Este exemplo demonstra chamadas básicas de API do MSS e não representa uma prática recomendada. Baixe o código de práticas recomendadas na página Obter exemplo de código.
public void button1Clicked(View view)
{
// Use the getUtdid method to obtain the device ID.
String utdid =UTDevice.getUtdid(MainActivity.this);
// Print the MSS data in Logcat.
Log.e("=========",utdid);
// Initialize the API and the MSS service.
MPSync.initialize(MainActivity.this);
// Register a callback to receive business data. After the pushed data is received, the syncCallback is called.
MPSync.registerBiz("bizType",new SyncCallBackImpl());
// Establish a network connection with the server.
MPSync.appToForeground();
}
public class SyncCallBackImpl implements ISyncCallback
{
@Override
public void onReceiveMessage(SyncMessage syncMessage) {
// Print the MSS data in Logcat.
Log.e("=========",syncMessage.msgData);
// Notify the MSS server that the data is successfully received.
MPSync.reportMsgReceived(syncMessage);
}
}Suporte a TLS
Para ative conexões TLS em portas diferentes de 443, adicione os metadados mss_use_tls ao arquivo manifest e defina seu valor como YES.
As conexões na porta 443 usam TLS por padrão.