ClickOnce uygulamalarını yerelleştirme
Yerelleştirme, uygulamanızı belirli bir kültür için uygun hale getirme işlemidir. Bu işlem, kullanıcı arabirimi (UI) metnini bölgeye özgü bir dile çevirmeyi, doğru tarih ve para birimi biçimlendirmesini kullanmayı, formdaki denetimlerin boyutunu ayarlamayı ve gerekirse denetimleri sağdan sola yansıtmayı içerir.
Uygulamanızın yerelleştirilmesi, bir veya daha fazla uydu derlemesinin oluşturulmasıyla sonuçlanıyor. Her derleme belirli bir kültüre özgü kullanıcı arabirimi dizeleri, görüntüler ve diğer kaynakları içerir. (Uygulamanızın ana yürütülebilir dosyası, uygulamanızın varsayılan kültürüne yönelik dizeleri içerir.)
Bu konu başlığı altında, bir ClickOnce uygulamasını diğer kültürler için dağıtmanın üç yolu açıklanmaktadır:
Tüm uydu derlemelerini tek bir dağıtıma dahil edin.
Her kültür için tek bir uydu derlemesi dahil olmak üzere bir dağıtım oluşturun.
uydu derlemelerini isteğe bağlı olarak indirin.
Dağıtıma Tüm Uydu Derlemelerini Ekleme
Birden çok ClickOnce dağıtımı yayımlamak yerine, tüm uydu derlemelerini içeren tek bir ClickOnce dağıtımı yayımlayabilirsiniz.
Bu yöntem Visual Studio'da varsayılan yöntemdir. Visual Studio'da bu yöntemi kullanmak için ek bir çalışma yapmanız gerekmez.
Bu yöntemi MageUI.exe kullanmak için uygulamanızın kültürünü MageUI.exe'de nötr olarak ayarlamanız gerekir. Ardından, dağıtımınıza tüm uydu derlemelerini el ile eklemeniz gerekir. MageUI.exe'de, uygulama bildiriminizin Dosyalar sekmesindeki Doldur düğmesini kullanarak uydu derlemelerini ekleyebilirsiniz.
Bu yaklaşımın avantajı, tek bir dağıtım oluşturması ve yerelleştirilmiş dağıtım hikayenizi basitleştirmesidir. Çalışma zamanında, kullanıcının Windows işletim sisteminin varsayılan kültürüne bağlı olarak uygun uydu derlemesi kullanılır. Bu yaklaşımın bir dezavantajı, uygulama bir istemci bilgisayara yüklendiğinde veya güncelleştirildiğinde tüm uydu derlemelerini indirmesidir. Uygulamanızın çok sayıda dizesi varsa veya müşterilerinizin ağ bağlantısı yavaşsa, bu işlem uygulama güncelleştirmesi sırasında performansı etkileyebilir.
Not
Bu yaklaşım, uygulamanızın denetimlerin yüksekliğini, genişliğini ve konumunu farklı kültürlerdeki farklı metin dizesi boyutlarına uyacak şekilde otomatik olarak ayarladığını varsayar. Windows Forms, ve denetimleri ve özelliği de dahil olmak üzere FlowLayoutPanel formunuzu kolayca yerelleştirilebilir hale getirecek şekilde tasarlamanızı sağlayan çeşitli denetimler AutoSize ve TableLayoutPanel teknolojiler içerir. Ayrıca bkz . How to: Support localization on Windows forms using AutoSize and the TableLayoutPanel control.
Her kültür için bir dağıtım oluşturma
Bu dağıtım stratejisinde birden çok dağıtım oluşturursunuz. Her dağıtımda yalnızca belirli bir kültür için gereken uydu derlemesini eklersiniz ve dağıtımı bu kültüre özgü olarak işaretlersiniz.
Visual Studio'da bu yöntemi kullanmak için Yayımla sekmesindeki Yayımlama Dili özelliğini istediğiniz bölgeye ayarlayın. Visual Studio seçtiğiniz bölge için gerekli uydu derlemesini otomatik olarak ekler ve diğer tüm uydu derlemelerini dağıtımdan dışlar.
Not
.NET Core 3.1 ve .NET 5 veya üzeri için ClickOnce'da, Yayımlama sihirbazı ve Proje Tasarımcısı'nın Yayımla sayfası yerine Yayımla aracını kullanarak dağıtım özelliklerini ayarlarsınız. Daha fazla bilgi için bkz. .NET için ClickOnce ve ClickOnce kullanarak bir .NET Windows uygulaması dağıtma.
Microsoft Windows Yazılım Geliştirme Seti'ndeki (SDK) MageUI.exe aracını kullanarak da aynı şeyi gerçekleştirebilirsiniz. Uygulama bildiriminizin Dosyalar sekmesindeki Doldur düğmesini kullanarak diğer tüm uydu derlemelerini uygulama dizininden hariç tutun ve ardından MageUI.exe dağıtım bildiriminiz için Ad sekmesindeki Kültür alanını ayarlayın. Bu adımlar yalnızca doğru uydu derlemesini içermez, aynı zamanda dağıtım bildiriminizdeki öğesinde assemblyIdentity özniteliğini ilgili kültüre ayarlarlanguage.
Uygulamayı yayımladıktan sonra, uygulamanızın desteklediği her ek kültür için bu adımı yinelemelisiniz. Her uygulama bildirimi farklı bir uydu derlemesine başvuracağından ve her dağıtım bildiriminin özniteliği için farklı bir değere sahip olacağı için her seferinde farklı bir Web sunucusu dizinine veya dosya paylaşımı dizinine yayımladığınızdan language emin olmanız gerekir.
İsteğe bağlı uydu derlemelerini indirme
Tüm uydu derlemelerini tek bir dağıtıma dahil etmeye karar verirseniz isteğe bağlı indirmeyi kullanarak performansı geliştirebilir ve bu sayede derlemeleri isteğe bağlı olarak işaretleyebilirsiniz. uygulama yüklendiğinde veya güncelleştirildiğinde işaretli derlemeler indirilmez. Sınıfındaki yöntemini ApplicationDeployment çağırarak DownloadFileGroup derlemeleri ihtiyacınız olduğunda yükleyebilirsiniz.
Not
ApplicationDeployment Ad alanı içindeki System.Deployment.Application sınıf ve API'ler .NET Core ve .NET 5 ve sonraki sürümlerde desteklenmez. .NET 7'de, uygulama dağıtım özelliklerine erişmek için yeni bir yöntem desteklenir. Daha fazla bilgi için bkz . .NET'te ClickOnce dağıtım özelliklerine erişme. .NET 7, ApplicationDeployment yöntemlerinin eşdeğerini desteklemez.
Uydu derlemelerinin isteğe bağlı olarak indirilmesi, isteğe bağlı olarak diğer derleme türlerini indirmekten biraz farklıdır. ClickOnce için Windows SDK araçlarını kullanarak bu senaryoyu etkinleştirme hakkında daha fazla bilgi ve kod örnekleri için bkz . İzlenecek Yol: ClickOnce Dağıtım API'siyle İsteğe Bağlı Uydu Derlemelerini İndirme.
Bu senaryoları Visual Studio'da da etkinleştirebilirsiniz. Daha fazla bilgi için bkz . İzlenecek Yol: Tasarımcı Kullanarak ClickOnce Dağıtım API'siyle İsteğe Bağlı Uydu Derlemelerini İndirme.
Dağıtımdan önce yerelleştirilmiş ClickOnce uygulamalarını test etme
Bir uydu derlemesi, bir Windows Forms uygulaması için yalnızca uygulamanın ana iş parçacığının özelliği uydu derlemesinin kültürüne ayarlanırsa CurrentUICulture kullanılır. Yerel pazarlardaki müşteriler, büyük olasılıkla kendi kültürleri uygun varsayılana ayarlanmış yerelleştirilmiş bir Windows sürümü çalıştırıyor olacaktır.
Uygulamanızı müşterilerin kullanımına sunmadan önce yerelleştirilmiş dağıtımları test etmek için üç seçeneğiniz vardır:
ClickOnce uygulamanızı Windows'un uygun yerelleştirilmiş sürümlerinde çalıştırabilirsiniz.
Özelliği uygulamanızda program aracılığıyla ayarlayabilirsiniz CurrentUICulture . (Yöntemi çağırmadan Run önce bu özellik ayarlanmalıdır.)