Bagikan melalui

Melokalisasi aplikasi ClickOnce

Pelokalan adalah proses membuat aplikasi Anda sesuai untuk budaya tertentu. Proses ini melibatkan penerjemahan teks antarmuka pengguna (UI) ke bahasa khusus wilayah, menggunakan tanggal dan pemformatan mata uang yang benar, menyesuaikan ukuran kontrol pada formulir, dan mencerminkan kontrol dari kanan ke kiri jika perlu.

Melokalisasi aplikasi Anda menghasilkan pembuatan satu atau beberapa rakitan satelit. Setiap rakitan berisi string UI, gambar, dan sumber daya lain khusus untuk budaya tertentu. (File utama yang dapat dieksekusi aplikasi Anda berisi string untuk budaya default untuk aplikasi Anda.)

Topik ini menjelaskan tiga cara untuk menyebarkan aplikasi ClickOnce untuk budaya lain:

  • Sertakan semua rakitan satelit dalam satu penyebaran.

  • Hasilkan satu penyebaran untuk setiap budaya, dengan satu rakitan satelit termasuk dalam masing-masing.

  • Unduh rakitan satelit sesuai permintaan.

Termasuk Semua Rakitan Satelit dalam Penyebaran

Daripada menerbitkan beberapa penyebaran ClickOnce, Anda dapat menerbitkan satu penyebaran ClickOnce yang berisi semua rakitan satelit.

Metode ini adalah default di Visual Studio. Untuk menggunakan metode ini di Visual Studio, Anda tidak perlu melakukan pekerjaan tambahan apa pun.

Untuk menggunakan metode ini dengan MageUI.exe, Anda harus mengatur budaya agar aplikasi Anda netral di MageUI.exe. Selanjutnya, Anda harus menyertakan semua rakitan satelit secara manual dalam penyebaran Anda. Di MageUI.exe, Anda dapat menambahkan rakitan satelit dengan menggunakan tombol Isi pada tab File manifes aplikasi Anda.

Manfaat dari pendekatan ini adalah membuat satu penyebaran dan menyederhanakan cerita penyebaran yang dilokalkan. Pada waktu proses, rakitan satelit yang sesuai akan digunakan, tergantung pada budaya default sistem operasi Windows pengguna. Kelemahan dari pendekatan ini adalah bahwa ia mengunduh semua rakitan satelit setiap kali aplikasi diinstal atau diperbarui pada komputer klien. Jika aplikasi Anda memiliki sejumlah besar string, atau pelanggan Anda memiliki koneksi jaringan yang lambat, proses ini dapat memengaruhi performa selama pembaruan aplikasi.

Nota

Pendekatan ini mengasumsikan bahwa aplikasi Anda menyesuaikan tinggi, lebar, dan posisi kontrol secara otomatis untuk mengakomodasi ukuran string teks yang berbeda dalam budaya yang berbeda. Windows Forms berisi berbagai kontrol dan teknologi yang memungkinkan Anda merancang formulir agar mudah dilokalisasi, termasuk FlowLayoutPanel kontrol dan TableLayoutPanel serta AutoSize properti. Lihat juga Cara: Mendukung pelokalan pada formulir Windows menggunakan AutoSize dan kontrol TableLayoutPanel.

Hasilkan satu penyebaran untuk setiap budaya

Dalam strategi penyebaran ini, Anda menghasilkan beberapa penyebaran. Dalam setiap penyebaran, Anda hanya menyertakan perakitan satelit yang diperlukan untuk budaya tertentu, dan Anda menandai penyebaran sebagai khusus untuk budaya tersebut.

Untuk menggunakan metode ini di Visual Studio, atur properti Terbitkan Bahasa pada tab Terbitkan ke wilayah yang diinginkan. Visual Studio akan secara otomatis menyertakan rakitan satelit yang diperlukan untuk wilayah yang Anda pilih, dan akan mengecualikan semua rakitan satelit lainnya dari penyebaran.

Nota

Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, Anda mengatur properti penyebaran menggunakan alat Terbitkan alih-alih panduan Terbitkan dan halaman Terbitkan Desainer Proyek. Untuk informasi selengkapnya, lihat Menyebarkan aplikasi .NET Windows menggunakan ClickOnce dan ClickOnce untuk .NET.

Anda dapat menyelesaikan hal yang sama dengan menggunakan alat MageUI.exe di Microsoft Windows Software Development Kit (SDK). Gunakan tombol Isi pada tab File manifes aplikasi Anda untuk mengecualikan semua rakitan satelit lainnya dari direktori aplikasi, lalu atur bidang Budaya pada tab Nama untuk manifes penyebaran Anda di MageUI.exe. Langkah-langkah ini tidak hanya mencakup perakitan satelit yang benar, tetapi juga mengatur language atribut pada assemblyIdentity elemen dalam manifes penyebaran Anda ke budaya yang sesuai.

Setelah menerbitkan aplikasi, Anda harus mengulangi langkah ini untuk setiap budaya tambahan yang didukung aplikasi Anda. Anda harus memastikan bahwa Anda menerbitkan ke direktori server Web atau direktori berbagi file yang berbeda setiap kali, karena setiap manifes aplikasi akan mereferensikan perakitan satelit yang berbeda, dan setiap manifes penyebaran akan memiliki nilai yang berbeda untuk atribut.language

Unduh rakitan satelit sesuai permintaan

Jika Anda memutuskan untuk menyertakan semua rakitan satelit dalam satu penyebaran, Anda dapat meningkatkan performa dengan menggunakan pengunduhan sesuai permintaan, yang memungkinkan Anda menandai rakitan sebagai opsional. Rakitan yang ditandai tidak akan diunduh ketika aplikasi diinstal atau diperbarui. Anda dapat menginstal rakitan saat membutuhkannya dengan memanggil metode DownloadFileGroup pada kelas ApplicationDeployment.

Nota

Kelas ApplicationDeployment dan API di System.Deployment.Application namespace tidak didukung dalam .NET Core dan .NET 5 dan versi yang lebih baru. Di .NET 7, metode baru untuk mengakses properti penyebaran aplikasi didukung. Untuk informasi selengkapnya, lihat Properti penyebaran Access ClickOnce di .NET. .NET 7 tidak mendukung metode ApplicationDeployment yang setara.

Mengunduh rakitan satelit sesuai permintaan sedikit berbeda dari mengunduh jenis rakitan lain sesuai permintaan. Untuk informasi selengkapnya dan contoh kode tentang cara mengaktifkan skenario ini menggunakan alat Windows SDK untuk ClickOnce, lihat Panduan: Mengunduh Rakitan Satelit sesuai Permintaan dengan API Penyebaran ClickOnce.

Anda juga dapat mengaktifkan skenario ini di Visual Studio. Untuk informasi selengkapnya, lihat Panduan: Mengunduh Rakitan Satelit sesuai Permintaan dengan API Penyebaran ClickOnce Menggunakan Perancang.

Menguji aplikasi ClickOnce yang dilokalkan sebelum penyebaran

Rakitan satelit akan digunakan untuk aplikasi Windows Forms hanya jika CurrentUICulture properti untuk utas utama aplikasi diatur ke budaya perakitan satelit. Pelanggan di pasar lokal mungkin sudah menjalankan versi Windows yang dilokalkan dengan budaya mereka diatur ke default yang sesuai.

Anda memiliki tiga opsi untuk menguji penyebaran yang dilokalkan sebelum membuat aplikasi Anda tersedia untuk pelanggan:

  • Anda dapat menjalankan aplikasi ClickOnce pada versi Windows yang dilokalkan yang sesuai.

  • Anda dapat mengatur CurrentUICulture properti secara terprogram di aplikasi Anda. (Properti ini harus diatur sebelum Anda memanggil metode Run.)

Konten terkait

  • Last updated on