Melhores práticas para distribuição de arquivos e aplicativos - Cloud Phone: Central de Documentação do Alibaba Cloud

A API SendFile permite enviar arquivos do Object Storage Service (OSS) para uma pasta específica em instâncias do Cloud Phone ou usar um link público de download para distribuir e instalar automaticamente pacotes de aplicativos. Este tópico aborda quatro casos de uso típicos de distribuição de arquivos e aplicativos.

Pré-requisitos

Pré-requisitos gerais para todos os casos de uso:
- Todas as instâncias do Cloud Phone de destino estão na mesma região.
- O status de todas as instâncias do Cloud Phone de destino é Active.
Pré-requisitos específicos para o Caso de uso 4 (Download da Internet e distribuição interna):
- A primeira instância do Cloud Phone tem permissões de acesso à Internet.
- A primeira instância do Cloud Phone tem espaço de armazenamento suficiente para o arquivo ou aplicativo.
- Você ativou o OSS. Nesse cenário, apenas a primeira instância do Cloud Phone baixe o arquivo ou aplicativo da Internet e o envia para um bucket do OSS de sua propriedade na mesma região.
  
  Importante
  O armazenamento no OSS gera custos adicionais. Para mais informações, consulte Visão geral do faturamento.

Caso de uso 1: Enviar um arquivo comum

Cenário

Envie o arquivo snapshot.png de um bucket do OSS na região China (Hangzhou) para a pasta /sdcard/Pictures nas instâncias do Cloud Phone acp-c8rzmx8fnwba6**** e acp-5fc8mx8fnw9s5**** na mesma região.

Exemplo de chamada da API SendFile

Mensagem de solicitação

{
    "AndroidInstanceIdList": [
        "acp-c8rzmx8fnwba6****",
        "acp-5fc8mx8fnw9s5****"
    ],
    "SourceFilePath": "/sdcard/Pictures",
    "UploadType": "OSS",
    "UploadUrl": "oss://cloudphone-saved-bucket-cn-hangzhou-****/picture/snapshot.png",
    "UploadEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com"
}

Mensagem de resposta

{
  "TaskId": "t-gk0ahswe4blor****",
  "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****",
  "Data": [
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-c8rzmx8fnwba6****"
    },
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-5fc8mx8fnw9s5****"
    }
  ]
}

Caso de uso 2: Enviar e instale automaticamente um pacote de aplicativo

Cenário

Você tem um pacote de aplicativo chamado SogouInput_12.15.0_android_sweb.apk em um bucket do OSS na região China (Hangzhou). Execute as seguintes tarefas:

Envie o pacote para a pasta /sdcard/Download nas instâncias do Cloud Phone acp-c8rzmx8fnwba6**** e acp-5fc8mx8fnw9s5**** na região China (Hangzhou).
Renomeie-o para sougou.apk.
Instale o aplicativo automaticamente após a conclusão do envio.

Exemplo de chamada da API SendFile

Mensagem de solicitação

{
    "AndroidInstanceIdList": [
        "acp-c8rzmx8fnwba6****",
        "acp-5fc8mx8fnw9s5****"
    ],
    "SourceFilePath": "/sdcard/Download",
    "UploadType": "OSS",
    "UploadUrl": "oss://cloudphone-saved-bucket-cn-hangzhou-****/app/SogouInput_12.15.0_android_sweb.apk",
    "UploadEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com",
    "TargetFileName": "sougou.apk",
    "AutoInstall": "true"
}

Mensagem de resposta

{
  "TaskId": "t-gk0ahswe4blor****",
  "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****",
  "Data": [
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-c8rzmx8fnwba6****"
    },
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-5fc8mx8fnw9s5****"
    }
  ]
}

Caso de uso 3: Baixe e instale automaticamente um pacote de aplicativo da Internet (modo de download individual)

Cenário

Você tem um link de download para um pacote de aplicativo: https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk. Execute as seguintes tarefas:

As instâncias do Cloud Phone acp-c8rzmx8fnwba6**** e acp-5fc8mx8fnw9s5**** na região China (Hangzhou) baixam o pacote da Internet individualmente, salve-no na pasta /sdcard/Download e renomeiam-no para sougou.apk.
Instale o aplicativo automaticamente após a conclusão do download.

Exemplo de chamada da API SendFile

Mensagem de solicitação

{
    "AndroidInstanceIdList": [
        "acp-c8rzmx8fnwba6****",
        "acp-5fc8mx8fnw9s5****"
    ],
    "SourceFilePath": "/sdcard/Download/sougou.apk",
    "UploadType": "DOWNLOAD_URL",
    "UploadUrl": "https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk",
    "AutoInstall": "true"
}

Mensagem de resposta

{
  "TaskId": "t-gk0ahswe4blor****",
  "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****",
  "Data": [
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-c8rzmx8fnwba6****"
    },
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-5fc8mx8fnw9s5****"
    }
  ]
}

Caso de uso 4: Baixe e instale automaticamente um pacote de aplicativo da Internet (modo de download da Internet com distribuição interna)

Cenário

Você tem um link de download para um pacote de aplicativo: https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk. Execute as seguintes tarefas:

A instância 1 do Cloud Phone, acp-c8rzmx8fnwba6****, na região China (Hangzhou) e com acesso à Internet, baixe o pacote da Internet. Em seguida, salve o pacote na pasta /sdcard/Download, renomeia-o para sougou.apk e instale o aplicativo automaticamente.
Envie o pacote pela rede interna para um bucket padrão do OSS de sua propriedade na mesma região.
Distribua o pacote via rede interna para outras instâncias especificadas do Cloud Phone na mesma região, como a instância 2 do Cloud Phone acp-5fc8mx8fnw9s5****, e instale o aplicativo automaticamente.

Nota

A primeira instância do Cloud Phone deve ter permissões de acesso à Internet e espaço de armazenamento suficiente. Caso contrário, não será possível baixar e armazenar o pacote do aplicativo.
Em comparação ao Caso de uso 3, este caso reduz os custos de transferência de dados, mas gera custos adicionais de armazenamento no OSS, pois usa um bucket padrão como ponto de trânsito. Escolha o caso de uso mais adequado às suas necessidades.

Exemplo de chamada da API SendFile

Mensagem de solicitação

{
    "AndroidInstanceIdList": [
        "acp-c8rzmx8fnwba6****",
        "acp-5fc8mx8fnw9s5****"
    ],
    "SourceFilePath": "/sdcard/Download",
    "UploadType": "OSS_BRIDGED",
    "UploadUrl": "https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk",
    "UploadEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com",
    "TargetFileName": "sougou.apk",
    "AutoInstall": "true"
}

Mensagem de resposta

{
  "TaskId": "t-gk0ahswe4blor****",
  "RequestId": "5D6FB544-F20E-14F8-B627-3F32C337****",
  "Data": [
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-c8rzmx8fnwba6****"
    },
    {
      "TaskId": "t-gk0ahswe4blor****",
      "AndroidInstanceId": "acp-5fc8mx8fnw9s5****"
    }
  ]
}

Próximas etapas

Após o sucesso da chamada da API, use a API DescribeTasks para consultar o progresso e o status da tarefa usando o TaskId retornado.

Comparação entre casos de uso

Casos de uso 1 e 2: Se o arquivo ou pacote de aplicativo estiver armazenado em um bucket do OSS na mesma região das instâncias do Cloud Phone, a distribuição ocorre pela rede interna e não consome tráfego de Internet.
Caso de uso 3: Se o arquivo ou pacote de aplicativo estiver na Internet, cada instância do Cloud Phone baixa sua própria cópia. Isso consome tráfego de Internet.
Caso de uso 4: Se o arquivo ou pacote de aplicativo estiver na Internet, uma instância do Cloud Phone o baixa e armazena em cache em um bucket do OSS de sua propriedade na mesma região. A cópia em cache é então distribuída para todas as outras instâncias do Cloud Phone pela rede interna, consumindo apenas uma pequena quantidade de tráfego de Internet.