Todos os produtos
Search

Este produto

    Mobile Platform as a Service:API

    Central de documentação

    Mobile Platform as a Service:API

    Última atualização: Jun 28, 2026

    Descreve a API do SDK de atualização para Android, incluindo métodos de verificação de versão e métodos de callback de upgrade.

    Descreve a API do SDK de atualização para Android, incluindo métodos de verificação de versão e métodos de callback de upgrade.

    API MPaaSCheckVersionService

    MPaaSCheckVersionService fornece métodos para iniciar verificações de versão, configure a frequência de verificação, registrar um callback e acionar o baixe e a instalação do APK.

    checkNewVersion

    Verifica se uma nova versão está disponível. Inicia uma tarefa assíncrona que chama o método de callback apropriado de MPaaSCheckCallBack, independentemente do resultado.

    void checkNewVersion(Activity activity)

    setIntervalTime

    Defina o intervalo mínimo entre verificações de versão repetidas, em milissegundos. O valor padrão é de 3 dias.

    Quando checkNewVersion é chamado antes desse intervalo decorrer, o SDK ignora a verificação de rede e aciona MPaaSCheckCallBack.onLimit. Isso se aplica apenas quando a configuração está definida como Single reminder.

    void setIntervalTime(long interval202)

    setMPaasCheckCallBack

    Registra a instância de callback que recebe os resultados da verificação de versão.

    void setMPaaSCheckCallBack(MPaaSCheckCallBack mPaaSCheckCallBack)

    installApk

    Instala o APK baixado. Chame este método dentro de MPaaSCheckCallBack.alreadyDownloaded quando o usuário confirmar a instalação.

    void installApk(String filePath)
void installApk(ClientUpgradeRes res)

    atualize

    Inicia o baixe do APK da nova versão. Chame este método dentro de MPaaSCheckCallBack.showUpgradeDialog quando o usuário confirmar o upgrade.

    void update(ClientUpgradeRes res)

    API MPaaSCheckCallBack

    MPaaSCheckCallBack é a interface de callback que você implementa para tratar os resultados da verificação de versão. O SDK chama esses métodos na seguinte sequência, dependendo do resultado:

    1. startCheck — verificação iniciada

    2. Um dos seguintes: isUpdating, onException, dealDataInValid, dealHasNoNewVersion, alreadyDownloaded, showUpgradeDialog ou onLimit

    startCheck

    Chamado imediatamente após checkNewVersion iniciar uma verificação de versão. Utilize este método para exibir um indicador de carregamento ao usuário.

    void startCheck()

    isUpdating

    Invocado quando checkNewVersion é chamado enquanto uma verificação de versão já está em andamento.

    void isUpdating()

    onException

    Acionado quando a verificação de versão falha devido a uma exceção. Use o parâmetro throwable para registrar ou exibir o erro.

    void onException(Throwable throwable)

    dealDataInValid

    Executado quando o servidor retorna dados de versão que não podem ser analisados ou são inválidos. O parâmetro result contém a resposta bruta para fins de diagnóstico.

    void dealDataInValid(Activity activity, ClientUpgradeRes result)

    dealHasNoNewVersion

    Ocorre quando o servidor confirma que nenhuma nova versão está disponível. Use este método para fechar o indicador de carregamento ou notificar o usuário.

    void dealHasNoNewVersion(Activity activity, ClientUpgradeRes result)

    alreadyDownloaded

    Indica que uma nova versão está disponível e seu APK já foi baixado no dispositivo. Solicite ao usuário que instale o pacote. Se o usuário confirmar, chame MPaaSCheckVersionService.installApk.

    void alreadyDownloaded(Activity activity, ClientUpgradeRes result)

    showUpgradeDialog

    Sinaliza que uma nova versão está disponível, mas o APK ainda não foi baixado. Exiba uma caixa de diálogo perguntando se o usuário deseja fazer o upgrade. Caso o usuário confirme, chame MPaaSCheckVersionService.update para iniciar o baixe.

    void showUpgradeDialog(Activity activity, ClientUpgradeRes result)

    onLimit

    Disparado quando uma nova versão está disponível, mas o intervalo defina por MPaaSCheckVersionService.setIntervalTime não decorreu desde a última verificação. Válido apenas quando a configuração está definida como Single reminder.

    void onLimit(Activity activity, ClientUpgradeRes result, String reason)