Buka konsol

Mengupload File di Android

Cloud Storage memungkinkan developer untuk mengupload file dengan cepat dan mudah ke bucket Google Cloud Storage yang disediakan dan dikelola oleh Firebase.

Mengupload File

Untuk mengupload file ke Cloud Storage, buat referensi ke lokasi lengkap file terlebih dahulu, termasuk nama filenya.

Java
Android

// Create a storage reference from our app
StorageReference storageRef = storage.getReference();

// Create a reference to "mountains.jpg"
StorageReference mountainsRef = storageRef.child("mountains.jpg");

// Create a reference to 'images/mountains.jpg'
StorageReference mountainImagesRef = storageRef.child("images/mountains.jpg");

// While the file names are the same, the references point to different files
mountainsRef.getName().equals(mountainImagesRef.getName());    // true
mountainsRef.getPath().equals(mountainImagesRef.getPath());    // false

Kotlin
Android

// Create a storage reference from our app
val storageRef = storage.reference

// Create a reference to "mountains.jpg"
val mountainsRef = storageRef.child("mountains.jpg")

// Create a reference to 'images/mountains.jpg'
val mountainImagesRef = storageRef.child("images/mountains.jpg")

// While the file names are the same, the references point to different files
mountainsRef.name == mountainImagesRef.name // true
mountainsRef.path == mountainImagesRef.path // false

Setelah membuat referensi yang sesuai, panggil metode putBytes(), putFile(), atau putStream() untuk mengupload file ke Cloud Storage.

Anda tidak dapat mengupload data dengan referensi ke root bucket Google Cloud Storage. Referensi Anda harus mengarah ke URL turunan.

Mengupload dari data di memori

Metode putBytes() adalah cara termudah untuk mengupload file ke Cloud Storage. putBytes() mengambil byte[] dan mengembalikan UploadTask yang dapat Anda gunakan untuk mengelola serta memantau status upload.

Java
Android

// Get the data from an ImageView as bytes
imageView.setDrawingCacheEnabled(true);
imageView.buildDrawingCache();
Bitmap bitmap = ((BitmapDrawable) imageView.getDrawable()).getBitmap();
ByteArrayOutputStream baos = new ByteArrayOutputStream();
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, baos);
byte[] data = baos.toByteArray();

UploadTask uploadTask = mountainsRef.putBytes(data);
uploadTask.addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception exception) {
        // Handle unsuccessful uploads
    }
}).addOnSuccessListener(new OnSuccessListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onSuccess(UploadTask.TaskSnapshot taskSnapshot) {
        // taskSnapshot.getMetadata() contains file metadata such as size, content-type, etc.
        // ...
    }
});

Kotlin
Android

// Get the data from an ImageView as bytes
imageView.isDrawingCacheEnabled = true
imageView.buildDrawingCache()
val bitmap = (imageView.drawable as BitmapDrawable).bitmap
val baos = ByteArrayOutputStream()
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, baos)
val data = baos.toByteArray()

var uploadTask = mountainsRef.putBytes(data)
uploadTask.addOnFailureListener {
    // Handle unsuccessful uploads
}.addOnSuccessListener {
    // taskSnapshot.metadata contains file metadata such as size, content-type, etc.
    // ...
}

Karena putBytes() menerima byte[], aplikasi Anda harus menahan seluruh konten file dalam memori sekaligus. Pertimbangkan untuk menggunakan putStream() atau putFile() untuk menggunakan lebih sedikit memori.

Mengupload dari stream

Metode putStream() adalah cara paling serbaguna untuk mengupload file ke Cloud Storage. putStream() mengambil InputStream dan mengembalikan UploadTask yang dapat Anda gunakan untuk mengelola serta memantau status upload.

Java
Android

InputStream stream = new FileInputStream(new File("path/to/images/rivers.jpg"));

uploadTask = mountainsRef.putStream(stream);
uploadTask.addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception exception) {
        // Handle unsuccessful uploads
    }
}).addOnSuccessListener(new OnSuccessListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onSuccess(UploadTask.TaskSnapshot taskSnapshot) {
        // taskSnapshot.getMetadata() contains file metadata such as size, content-type, etc.
        // ...
    }
});

Kotlin
Android

val stream = FileInputStream(File("path/to/images/rivers.jpg"))

uploadTask = mountainsRef.putStream(stream)
uploadTask.addOnFailureListener {
    // Handle unsuccessful uploads
}.addOnSuccessListener {
    // taskSnapshot.metadata contains file metadata such as size, content-type, etc.
    // ...
}

Mengupload dari file lokal

Anda dapat mengupload file lokal di perangkat, seperti foto dan video dari kamera, dengan metode putFile(). putFile() mengambil File dan mengembalikan UploadTask yang dapat Anda gunakan untuk mengelola serta memantau status upload.

Java
Android

Uri file = Uri.fromFile(new File("path/to/images/rivers.jpg"));
StorageReference riversRef = storageRef.child("images/"+file.getLastPathSegment());
uploadTask = riversRef.putFile(file);

// Register observers to listen for when the download is done or if it fails
uploadTask.addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception exception) {
        // Handle unsuccessful uploads
    }
}).addOnSuccessListener(new OnSuccessListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onSuccess(UploadTask.TaskSnapshot taskSnapshot) {
        // taskSnapshot.getMetadata() contains file metadata such as size, content-type, etc.
        // ...
    }
});

Kotlin
Android

var file = Uri.fromFile(File("path/to/images/rivers.jpg"))
val riversRef = storageRef.child("images/${file.lastPathSegment}")
uploadTask = riversRef.putFile(file)

// Register observers to listen for when the download is done or if it fails
uploadTask.addOnFailureListener {
    // Handle unsuccessful uploads
}.addOnSuccessListener {
    // taskSnapshot.metadata contains file metadata such as size, content-type, etc.
    // ...
}

Mendapatkan URL download

Setelah mengupload file, Anda bisa mendapatkan URL untuk mendownload file tersebut dengan memanggil metode getDownloadUrl() pada StorageReference:

Java
Android

final StorageReference ref = storageRef.child("images/mountains.jpg");
uploadTask = ref.putFile(file);

Task<Uri> urlTask = uploadTask.continueWithTask(new Continuation<UploadTask.TaskSnapshot, Task<Uri>>() {
    @Override
    public Task<Uri> then(@NonNull Task<UploadTask.TaskSnapshot> task) throws Exception {
        if (!task.isSuccessful()) {
            throw task.getException();
        }

        // Continue with the task to get the download URL
        return ref.getDownloadUrl();
    }
}).addOnCompleteListener(new OnCompleteListener<Uri>() {
    @Override
    public void onComplete(@NonNull Task<Uri> task) {
        if (task.isSuccessful()) {
            Uri downloadUri = task.getResult();
        } else {
            // Handle failures
            // ...
        }
    }
});

Kotlin
Android

val ref = storageRef.child("images/mountains.jpg")
uploadTask = ref.putFile(file)

val urlTask = uploadTask.continueWithTask(Continuation<UploadTask.TaskSnapshot, Task<Uri>> { task ->
    if (!task.isSuccessful) {
        task.exception?.let {
            throw it
        }
    }
    return@Continuation ref.downloadUrl
}).addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val downloadUri = task.result
    } else {
        // Handle failures
        // ...
    }
}

Menambahkan Metadata File

Anda juga dapat menyertakan metadata ketika mengupload file. Metadata ini berisi properti metadata file standar seperti name, size, dan contentType (umumnya dikenal sebagai jenis MIME). Metode putFile() secara otomatis memasukkan jenis MIME dari ekstensi File, tetapi Anda dapat mengganti jenis yang terdeteksi secara otomatis dengan menentukan contentType dalam metadata. Jika Anda tidak memberikan contentType dan Cloud Storage tidak dapat menyimpulkan default dari ekstensi file, Cloud Storage akan menggunakan application/octet-stream. Baca bagian Menggunakan Metadata File untuk mengetahui informasi lebih lanjut mengenai metadata file.

Java
Android

// Create file metadata including the content type
StorageMetadata metadata = new StorageMetadata.Builder()
        .setContentType("image/jpg")
        .build();

// Upload the file and metadata
uploadTask = storageRef.child("images/mountains.jpg").putFile(file, metadata);

Kotlin
Android

// Create file metadata including the content type
var metadata = StorageMetadata.Builder()
        .setContentType("image/jpg")
        .build()

// Upload the file and metadata
uploadTask = storageRef.child("images/mountains.jpg").putFile(file, metadata)

Mengelola Upload

Selain memulai upload, Anda dapat menjeda, melanjutkan, dan membatalkan upload menggunakan metode pause(), resume(), dan cancel(). Bila aktivitas dijeda dan dilanjutkan, masing-masing tindakan ini akan meningkatkan perubahan status pause dan progress. Jika dibatalkan, upload akan gagal dengan pesan error yang menunjukkan bahwa upload telah dibatalkan.

Java
Android

uploadTask = storageRef.child("images/mountains.jpg").putFile(file);

// Pause the upload
uploadTask.pause();

// Resume the upload
uploadTask.resume();

// Cancel the upload
uploadTask.cancel();

Kotlin
Android

uploadTask = storageRef.child("images/mountains.jpg").putFile(file)

// Pause the upload
uploadTask.pause()

// Resume the upload
uploadTask.resume()

// Cancel the upload
uploadTask.cancel()

Memantau Kemajuan Upload

Anda dapat menambahkan listener untuk menangani keberhasilan, kegagalan, kemajuan, atau jeda dalam tugas upload:

Jenis Listener Penggunaan Standar
OnProgressListener Listener ini dipanggil secara berkala saat data ditransfer, dan dapat digunakan untuk mengisi indikator upload/download.
OnPausedListener Listener ini dipanggil kapan pun tugas dijeda.
OnSuccessListener Listener ini dipanggil saat tugas berhasil diselesaikan.
OnFailureListener Listener ini dipanggil kapan pun upload gagal. Hal ini dapat terjadi karena waktu tunggu jaringan, kegagalan otorisasi, atau jika Anda membatalkan tugas.

OnFailureListener dipanggil dengan instance Exception. Listener lainnya dipanggil dengan objek UploadTask.TaskSnapshot. Objek ini adalah tampilan tetap dari tugas pada saat peristiwa tersebut terjadi. UploadTask.TaskSnapshot berisi properti berikut:

Properti Jenis Deskripsi
getDownloadUrl String URL yang dapat digunakan untuk mendownload objek. Ini adalah URL yang tidak dapat diperkirakan publik, yang dapat dibagikan dengan klien lain. Nilai ini diisi setelah upload selesai.
getError Exception Jika tugas gagal, penyebabnya akan muncul sebagai Pengecualian.
getBytesTransferred long Total jumlah byte yang telah ditransfer saat snapshot ini diambil.
getTotalByteCount long Total perkiraan jumlah byte yang akan diupload.
getUploadSessionUri String URI yang dapat digunakan untuk melanjutkan tugas ini melalui panggilan lain ke putFile.
getMetadata StorageMetadata Sebelum upload selesai, ini adalah metadata yang dikirim ke server. Setelah upload selesai, ini adalah metadata yang ditampilkan oleh server.
getTask UploadTask Tugas yang membuat snapshot ini. Gunakan tugas ini untuk membatalkan, menjeda, atau melanjutkan upload.
getStorage StorageReference StorageReference digunakan untuk membuat UploadTask.

Listener peristiwa UploadTask memberikan cara sederhana dan efektif untuk memantau peristiwa upload.

Java
Android

// Observe state change events such as progress, pause, and resume
uploadTask.addOnProgressListener(new OnProgressListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onProgress(UploadTask.TaskSnapshot taskSnapshot) {
        double progress = (100.0 * taskSnapshot.getBytesTransferred()) / taskSnapshot.getTotalByteCount();
        System.out.println("Upload is " + progress + "% done");
    }
}).addOnPausedListener(new OnPausedListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onPaused(UploadTask.TaskSnapshot taskSnapshot) {
        System.out.println("Upload is paused");
    }
});

Kotlin
Android

// Observe state change events such as progress, pause, and resume
uploadTask.addOnProgressListener { taskSnapshot ->
    val progress = (100.0 * taskSnapshot.bytesTransferred) / taskSnapshot.totalByteCount
    System.out.println("Upload is $progress% done")
}.addOnPausedListener {
    System.out.println("Upload is paused")
}

Menangani Perubahan Siklus Hidup Aktivitas

Upload akan terus berlanjut di latar belakang bahkan setelah siklus proses aktivitas berubah (seperti menampilkan sebuah dialog atau memutar layar). Setiap listener yang telah terpasang juga akan tetap melekat. Listener yang dipanggil setelah aktivitas dihentikan dapat menyebabkan hasil yang tidak diharapkan.

Anda dapat mengatasi masalah ini dengan membuat listener berlangganan dengan cakupan aktivitas agar registrasinya dibatalkan secara otomatis saat aktivitas berhenti. Lalu, gunakan metode getActiveUploadTasks saat aktivitas dimulai ulang untuk memperoleh tugas upload yang masih berjalan atau baru saja diselesaikan.

Contoh di bawah memperlihatkan hal ini dan juga menampilkan cara mempertahankan lokasi referensi penyimpanan yang digunakan.

Java
Android

@Override
protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);

    // If there's an upload in progress, save the reference so you can query it later
    if (mStorageRef != null) {
        outState.putString("reference", mStorageRef.toString());
    }
}

@Override
protected void onRestoreInstanceState(Bundle savedInstanceState) {
    super.onRestoreInstanceState(savedInstanceState);

    // If there was an upload in progress, get its reference and create a new StorageReference
    final String stringRef = savedInstanceState.getString("reference");
    if (stringRef == null) {
        return;
    }
    mStorageRef = FirebaseStorage.getInstance().getReferenceFromUrl(stringRef);

    // Find all UploadTasks under this StorageReference (in this example, there should be one)
    List<UploadTask> tasks = mStorageRef.getActiveUploadTasks();
    if (tasks.size() > 0) {
        // Get the task monitoring the upload
        UploadTask task = tasks.get(0);

        // Add new listeners to the task using an Activity scope
        task.addOnSuccessListener(this, new OnSuccessListener<UploadTask.TaskSnapshot>() {
            @Override
            public void onSuccess(UploadTask.TaskSnapshot state) {
                // Success!
                // ...
            }
        });
    }
}

Kotlin
Android

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)

    // If there's an upload in progress, save the reference so you can query it later
    storageRef?.let {
        outState.putString("reference", it.toString())
    }
}

override fun onRestoreInstanceState(savedInstanceState: Bundle) {
    super.onRestoreInstanceState(savedInstanceState)

    // If there was an upload in progress, get its reference and create a new StorageReference
    val stringRef = savedInstanceState.getString("reference") ?: return

    storageRef = FirebaseStorage.getInstance().getReferenceFromUrl(stringRef)

    // Find all UploadTasks under this StorageReference (in this example, there should be one)

    storageRef?.activeUploadTasks?.let { it ->
        if (it.size > 0) {
            // Get the task monitoring the upload
            val task = it[0]

            // Add new listeners to the task using an Activity scope
            task.addOnSuccessListener(this) {
                // Success!
                // ...
            }
        }
    }
}

getActiveUploadTasks mengambil semua tugas upload aktif, pada dan di bawah referensi yang diberikan, sehingga Anda mungkin perlu menangani beberapa tugas.

Melanjutkan Upload Setelah Proses Dimulai Ulang

Jika proses Anda dihentikan, setiap upload yang sedang berjalan akan terhenti. Namun, Anda dapat terus mengupload setelah proses dimulai ulang dengan melanjutkan sesi upload melalui server. Hal ini dapat menghemat waktu dan bandwidth dengan tidak memulai upload dari awal file.

Untuk melakukannya, mulai upload melalui putFile. Pada StorageTask yang dihasilkan, panggil getUploadSessionUri dan simpan nilai yang dihasilkan dalam penyimpanan persisten (seperti SharedPreferences).

Java
Android

uploadTask = mStorageRef.putFile(localFile);
uploadTask.addOnProgressListener(new OnProgressListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onProgress(UploadTask.TaskSnapshot taskSnapshot) {
        Uri sessionUri = taskSnapshot.getUploadSessionUri();
        if (sessionUri != null && !mSaved) {
            mSaved = true;
            // A persisted session has begun with the server.
            // Save this to persistent storage in case the process dies.
        }
    }
});

Kotlin
Android

uploadTask = storageRef!!.putFile(localFile)
uploadTask.addOnProgressListener { taskSnapshot ->
    sessionUri = taskSnapshot.uploadSessionUri
    if (sessionUri != null && !saved) {
        saved = true
        // A persisted session has begun with the server.
        // Save this to persistent storage in case the process dies.
    }
}

Setelah proses dimulai ulang dengan upload yang terputus, panggil lagi putFile. Namun, kali ini teruskan juga Uri yang disimpan.

Java
Android

//resume the upload task from where it left off when the process died.
//to do this, pass the sessionUri as the last parameter
uploadTask = mStorageRef.putFile(localFile,
        new StorageMetadata.Builder().build(), sessionUri);

Kotlin
Android

// resume the upload task from where it left off when the process died.
// to do this, pass the sessionUri as the last parameter
uploadTask = storageRef!!.putFile(localFile,
        StorageMetadata.Builder().build(), sessionUri)

Sesi akan bertahan selama satu minggu. Jika Anda mencoba untuk melanjutkan sesi setelah masa berlakunya habis atau jika mengalami error, Anda akan menerima callback kegagalan. Andalah yang bertanggung jawab untuk memastikan file tidak berubah di antara upload.

Penanganan Error

Ada sejumlah alasan penyebab terjadinya error saat upload, termasuk tidak adanya file lokal, atau pengguna tidak memiliki izin untuk mengupload file yang diinginkan. Anda dapat menemukan informasi lebih lanjut mengenai error di bagian Menangani Error pada dokumentasi.

Contoh Lengkap

Contoh lengkap upload dengan pemantauan kemajuan dan penanganan error ditampilkan di bawah ini:

Java
Android

// File or Blob
file = Uri.fromFile(new File("path/to/mountains.jpg"));

// Create the file metadata
metadata = new StorageMetadata.Builder()
        .setContentType("image/jpeg")
        .build();

// Upload file and metadata to the path 'images/mountains.jpg'
uploadTask = storageRef.child("images/"+file.getLastPathSegment()).putFile(file, metadata);

// Listen for state changes, errors, and completion of the upload.
uploadTask.addOnProgressListener(new OnProgressListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onProgress(UploadTask.TaskSnapshot taskSnapshot) {
        double progress = (100.0 * taskSnapshot.getBytesTransferred()) / taskSnapshot.getTotalByteCount();
        System.out.println("Upload is " + progress + "% done");
    }
}).addOnPausedListener(new OnPausedListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onPaused(UploadTask.TaskSnapshot taskSnapshot) {
        System.out.println("Upload is paused");
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception exception) {
        // Handle unsuccessful uploads
    }
}).addOnSuccessListener(new OnSuccessListener<UploadTask.TaskSnapshot>() {
    @Override
    public void onSuccess(UploadTask.TaskSnapshot taskSnapshot) {
        // Handle successful uploads on complete
        // ...
    }
});

Kotlin
Android

// File or Blob
file = Uri.fromFile(File("path/to/mountains.jpg"))

// Create the file metadata
metadata = StorageMetadata.Builder()
        .setContentType("image/jpeg")
        .build()

// Upload file and metadata to the path 'images/mountains.jpg'
uploadTask = storageRef.child("images/${file.lastPathSegment}").putFile(file, metadata)

// Listen for state changes, errors, and completion of the upload.
uploadTask.addOnProgressListener { taskSnapshot ->
    val progress = (100.0 * taskSnapshot.bytesTransferred) / taskSnapshot.totalByteCount
    System.out.println("Upload is $progress% done")
}.addOnPausedListener {
    System.out.println("Upload is paused")
}.addOnFailureListener {
    // Handle unsuccessful uploads
}.addOnSuccessListener {
    // Handle successful uploads on complete
    // ...
}

Setelah mengupload file, pelajari cara mendownloadnya dari Cloud Storage.