Aracılığıyla paylaş

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.exeile kullanmak için uygulamanızın kültürünü MageUI.exeiçinde nötr olarak ayarlamanız gerekir. Ardından, dağıtımınıza tüm uydu derlemelerini el ile eklemeniz gerekmektedir. MageUI.exeiçinde, 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.

Uyarı

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, FlowLayoutPanel ve TableLayoutPanel denetimleri ile AutoSize özelliği de dahil olmak üzere formunuzu kolayca yerelleştirilebilir hale getirecek şekilde tasarlamanızı sağlayan çeşitli denetimler ve teknolojiler içerir. Ayrıca bkz Windows formlarında AutoSize ve TableLayoutPanel kontrolü kullanarak yerelleştirmeyi destekleme.

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.

Uyarı

.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 ClickOnce kullanarak bir .NET Windows uygulaması dağıtma ve .NET için ClickOnce.

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.exedağıtım bildiriminiz için Adsekmesindeki 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 language özniteliğini ilgili kültüre ayarlarassemblyIdentity.

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.

uydu derlemelerini isteğe bağlı olarak 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. İhtiyacınız olduğunda ApplicationDeployment sınıfındaki DownloadFileGroup yöntemini çağırarak derlemeleri yükleyebilirsiniz.

Uyarı

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 İzlenecek Tam Prosedür: Tasarımcı Kullanılarak ClickOnce Dağıtımı API'si ile İsteğe Bağlı Uydu Derlemelerini İndirme bölümüne bakın.

Dağıtımdan önce yerelleştirilmiş ClickOnce uygulamalarını test etme

Bir Windows Forms uygulaması için bir uydu derlemesi, yalnızca uygulamanın ana iş parçacığının özelliği uydu derlemesinin kültürüne ayarlandığında 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.)

İlgili içerik

  • Last updated on