Praktik terbaik untuk distribusi file dan aplikasi - Cloud Phone

Anda dapat menggunakan API SendFile untuk mengunggah file dari Object Storage Service (OSS) ke folder tertentu pada instans Cloud Phone. Anda juga dapat menggunakan tautan unduh publik untuk mengunggah paket aplikasi ke folder tertentu pada beberapa instans Cloud Phone dan menginstal aplikasi tersebut secara otomatis. Topik ini menjelaskan empat skenario khas yang menunjukkan cara menggunakan API ini untuk mendistribusikan file dan aplikasi.

Prasyarat

Prasyarat umum untuk semua skenario:
- Semua instans Cloud Phone target berada di wilayah yang sama.
- Status semua instans Cloud Phone target adalah Active.
Prasyarat khusus untuk Skenario 4 (unduh dari Internet dan distribusi internal):
- Instans Cloud Phone pertama tempat Anda ingin mengirim file memiliki izin akses Internet.
- Instans Cloud Phone pertama memiliki ruang penyimpanan yang cukup untuk file atau aplikasi yang akan didistribusikan.
- Anda telah mengaktifkan Object Storage Service (OSS). Dalam skenario ini, hanya instans Cloud Phone pertama yang mengunduh file atau aplikasi dari Internet. Instans tersebut kemudian mengunggah file atau aplikasi ke bucket OSS milik Anda di wilayah yang sama.
  Penting
  Penyimpanan OSS menimbulkan biaya tambahan. Untuk informasi selengkapnya, lihat Ikhtisar penagihan.

Skenario 1: Mengunggah file biasa

Skenario

Anda perlu mengunggah file snapshot.png dari bucket OSS di wilayah Tiongkok (Hangzhou) ke folder /sdcard/Pictures pada instans Cloud Phone acp-c8rzmx8fnwba6**** dan acp-5fc8mx8fnw9s5**** di wilayah yang sama.

Contoh pemanggilan API SendFile

Pesan permintaan

{
    "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"
}

Pesan respons

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

Skenario 2: Mengunggah dan menginstal otomatis paket aplikasi

Skenario

Anda memiliki paket aplikasi bernama SogouInput_12.15.0_android_sweb.apk di bucket OSS di wilayah Tiongkok (Hangzhou). Anda perlu melakukan tugas-tugas berikut:

Mengunggah paket tersebut ke folder /sdcard/Download pada instans Cloud Phone acp-c8rzmx8fnwba6**** dan acp-5fc8mx8fnw9s5**** di wilayah Tiongkok (Hangzhou).
Mengganti namanya menjadi sougou.apk.
Menginstal aplikasi secara otomatis setelah pengunggahan selesai.

Contoh pemanggilan API SendFile

Pesan permintaan

{
    "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"
}

Pesan respons

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

Skenario 3: Mengunduh dan menginstal otomatis paket aplikasi dari Internet (mode unduh individual)

Skenario

Anda memiliki tautan unduh untuk paket aplikasi: https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk. Anda perlu melakukan tugas-tugas berikut:

Instans Cloud Phone acp-c8rzmx8fnwba6**** dan acp-5fc8mx8fnw9s5**** di wilayah Tiongkok (Hangzhou) secara individual mengunduh paket dari Internet, menyimpannya ke folder /sdcard/Download, dan mengganti namanya menjadi sougou.apk.
Menginstal aplikasi secara otomatis setelah pengunduhan selesai.

Contoh pemanggilan API SendFile

Pesan permintaan

{
    "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"
}

Pesan respons

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

Skenario 4: Mengunduh dan menginstal otomatis paket aplikasi dari Internet (mode unduh Internet dan distribusi internal)

Skenario

Anda memiliki tautan unduh untuk paket aplikasi: https://apkdl.example.com/wapdl/android/apk/SogouInput_12.15.0_android_sweb.apk. Anda perlu melakukan tugas-tugas berikut:

Instans Cloud Phone 1, acp-c8rzmx8fnwba6****, di wilayah Tiongkok (Hangzhou), yang memiliki akses Internet, mengunduh paket dari Internet. Paket tersebut kemudian disimpan ke folder /sdcard/Download, diganti namanya menjadi sougou.apk, dan aplikasi diinstal secara otomatis.
Mengunggah paket melalui jaringan internal ke bucket OSS default milik Anda di wilayah yang sama.
Mendistribusikan paket melalui jaringan internal ke instans Cloud Phone lain yang ditentukan di wilayah yang sama, seperti instans Cloud Phone 2 acp-5fc8mx8fnw9s5****, lalu menginstal aplikasi secara otomatis.

Catatan

Dalam skenario ini, instans Cloud Phone pertama harus memiliki izin akses Internet dan ruang penyimpanan yang cukup. Jika tidak, paket aplikasi tidak dapat diunduh dan disimpan.
Dibandingkan dengan Skenario 3, skenario ini mengurangi biaya transfer data. Namun, karena menggunakan bucket OSS default sebagai titik transit, skenario ini juga menimbulkan biaya penyimpanan tambahan. Pilih skenario yang paling sesuai dengan kebutuhan Anda.

Contoh pemanggilan API SendFile

Pesan permintaan

{
    "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"
}

Pesan respons

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

Langkah selanjutnya

Setelah pemanggilan API berhasil, Anda dapat memanggil API DescribeTasks untuk menanyakan progres dan status tugas menggunakan TaskId yang dikembalikan.

Perbandingan skenario

Skenario 1 dan 2: Jika file atau paket aplikasi yang ingin Anda distribusikan disimpan di bucket OSS di wilayah yang sama dengan instans Cloud Phone, Cloud Phone mendistribusikannya melalui jaringan internal. Proses ini tidak mengonsumsi lalu lintas internet.
Skenario 3: Jika file atau paket aplikasi yang ingin Anda distribusikan berada di Internet, Cloud Phone mengunduh beberapa salinan dari Internet dan mendistribusikannya ke instans Cloud Phone Anda. Proses ini mengonsumsi lalu lintas internet.
Skenario 4: Jika file atau paket aplikasi yang ingin Anda distribusikan berada di Internet, Cloud Phone mengunduh satu salinan file atau paket dari Internet. Salinan tersebut kemudian di-cache di bucket OSS milik Anda di wilayah yang sama. Setelah itu, salinan tersebut didistribusikan ke semua instans Cloud Phone lainnya melalui jaringan internal. Proses ini hanya mengonsumsi sedikit lalu lintas internet.