Aracılığıyla paylaş


ClickOnce Yayımlama özelliklerini belirtme

ClickOnce Yayımlama özelliklerini Proje Tasarımcısı'nın Yayımla sayfasında veya Yayımlama Sihirbazı'nı kullanarak yapılandırabilirsiniz. Bu makalede yayımlama konumu, yükleme URL'si, çevrimiçi veya çevrimdışı yükleme modu ve yayımlama sürümü gibi özellikleri belirtmeyi öğreneceksiniz.

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.

Yayımlama konumu belirtme

ClickOnce kullanarak bir uygulama yayımladığınızda, özelliği uygulama Publish Location dosyalarının ve bildiriminin yerleştirildiği konumu belirtir. Bu bir dosya yolu veya FTP sunucusunun yolu olabilir.

Özelliğini Proje Tasarımcısı'nın Yayımla sayfasında veya Yayımlama Sihirbazı'nı kullanarak belirtebilirsinizPublish Location. Daha fazla bilgi için bkz . Nasıl yapılır: Yayımlama Sihirbazı'nı kullanarak ClickOnce Uygulaması Yayımlama.

Not

ClickOnce kullanarak bir uygulamanın birden fazla sürümünü yüklediğinizde, yükleme uygulamanın önceki sürümlerini belirttiğiniz yayımlama konumunda arşiv adlı bir klasöre taşır. Önceki sürümleri bu şekilde arşivleme, yükleme dizininin önceki sürümdeki klasörlerden uzak kalmasını sağlar.

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Yayımlama Konumu alanına aşağıdaki biçimlerden birini kullanarak yayımlama konumunu girin:

    • Bir dosya paylaşımında veya disk yolunda yayımlamak için, bir UNC yolu (\\Server\ApplicationName) veya bir dosya yolu (C:\Deploy\ApplicationName) kullanarak yolu girin.

    • FTP sunucusunda yayımlamak için yolu ftp://ftp.microsoft.com/< ApplicationName> biçimini kullanarak girin.

      Gözat (...) düğmesinin çalışması için Yayımlama Konumu kutusunda metnin bulunması gerektiğini unutmayın.

Son kullanıcıların yükleme yapacakları konumu belirtme

ClickOnce uygulamasını yayımlarken, kullanıcıların uygulamayı indirmek ve yüklemek için gittiği konum, uygulamayı ilk yayımladığınız konum olmayabilir. Örneğin, bazı kuruluşlarda bir geliştirici bir uygulamayı hazırlama sunucusuna yayımlayabilir ve ardından bir yönetici uygulamayı bir Web sunucusuna taşıyabilir.

Bu durumda, kullanıcıların uygulamayı indirmek için gideceği Web sunucusunu belirtmek için özelliğini kullanabilirsiniz Installation URL . Bu, uygulama bildiriminin güncelleştirmelerin nerede arandığını bilmesi için gereklidir.

Özelliği Proje Installation URL Tasarımcısı'nın Yayımla sayfasında ayarlanabilir.

Not

Özelliği Installation URL PublishWizard kullanılarak da ayarlanabilir. Daha fazla bilgi için bkz . Nasıl yapılır: Yayımlama Sihirbazı'nı kullanarak ClickOnce uygulaması yayımlama.

Yükleme URL'si belirtme

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Yükleme URL'si alanında, biçimini kullanarak tam URL kullanarak yükleme konumunu veya biçimini https://www.contoso.com/ApplicationName\Server\ApplicationNamekullanarak bir UNC yolu girin.

ClickOnce çevrimdışı veya çevrimiçi yükleme modunu belirtme

Install Mode ClickOnce uygulaması için, uygulamanın çevrimdışı mı yoksa çevrimiçi mi olacağını belirler. Uygulama yalnızca çevrimiçi kullanılabilir'i seçtiğinizde, kullanıcının uygulamayı çalıştırabilmesi için ClickOnce yayımlama konumuna (Web sayfası veya dosya paylaşımı) erişimi olmalıdır. Uygulama çevrimdışı da kullanılabilir'i seçtiğinizde, uygulama Başlangıç menüsüne ve Program Ekle veya Kaldır iletişim kutusuna girdiler ekler; kullanıcı bağlı olmadığında uygulamayı çalıştırabilir.

, Install Mode Proje Tasarımcısı'nın Yayımla sayfasında ayarlanabilir.

Not

, Install Mode Yayımlama sihirbazı kullanılarak da ayarlanabilir. Daha fazla bilgi için bkz . Nasıl yapılır: Yayımlama Sihirbazı'nı kullanarak ClickOnce uygulaması yayımlama.

ClickOnce uygulamasını yalnızca çevrimiçi kullanılabilir hale getirme

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Yükleme Modu ve Ayarlar alanında Uygulama yalnızca çevrimiçi kullanılabilir seçeneği düğmesine tıklayın.

ClickOnce uygulamasını çevrimiçi veya çevrimdışı kullanılabilir hale getirme

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Yükleme Modu ve Ayarlar alanında Uygulama çevrimdışı kullanılabilir seçeneği düğmesine de tıklayın.

    Uygulama yüklendiğinde Başlangıç menüsüne ve Denetim Masası'da Program Ekle veya Kaldır'a girdiler ekler.

ClickOnce yayım sürümünü ayarlama

ClickOnce Publish Version özelliği, yayımladığınız uygulamanın güncelleştirme olarak ele alınıp alınmayacağını belirler. Sürüm her artırıldığında, uygulama bir güncelleştirme olarak yayımlanır.

Özelliği Proje Publish Version Tasarımcısı'nın Yayımla sayfasında ayarlanabilir.

Not

Uygulama her yayımlandığında özelliği otomatik olarak artıran Publish Version bir proje seçeneği vardır; bu seçenek varsayılan olarak etkindir. Daha fazla bilgi için bkz . ClickOnce Yayımlama Sürümünü Otomatik Olarak Artırma.

Yayımlama sürümünü değiştirme

  1. Çözüm Gezgini'de bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Sürümü Yayımla alanında Ana, İkincil, Derleme veya Düzeltme sürüm numaralarını artırın.

    Not

    Sürüm numarasını asla azaltmamalısınız; bunu yapmak öngörülemeyen güncelleştirme davranışına neden olabilir.

ClickOnce yayım sürümünü otomatik olarak artırma

ClickOnce uygulamasını yayımlarken, özelliğinin Publish Version değiştirilmesi uygulamanın güncelleştirme olarak yayımlanmasına neden olur. Varsayılan olarak, Visual Studio uygulamayı her yayımladığınızda sayısını Publish Version otomatik olarak artırırRevision.

Bu davranışı Proje Tasarımcısı'nın Yayımla sayfasında devre dışı bırakabilirsiniz.

Not

Gördüğünüz iletişim kutuları ve menü komutları, etkin ayarlarınıza ve ürün sürümüne bağlı olarak Yardım menüsünde açıklanana göre farklılık gösterebilir. Ayarlarınızı değiştirmek için Araçlar menüsünde ayarları içeri ve dışarı aktar'ı seçin. Daha fazla bilgi için bkz . Ayarları sıfırlama.

Yayımlama sürümünü otomatik olarak artırmayı devre dışı bırakma

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Sürümü Yayımla bölümünde, Düzeltmeyi her sürümle otomatik olarak artır onay kutusunu temizleyin.

ClickOnce uygulaması için bir yayımlama sayfası belirtme

ClickOnce uygulamasını yayımlarken, uygulamayla birlikte varsayılan bir Web sayfası (publish.htm) oluşturulur ve yayımlanır. Bu sayfa uygulamanın adını, uygulamayı ve/veya önkoşulları yüklemek için bir bağlantı ve ClickOnce'ı açıklayan bir Yardım konusunun bağlantısını içerir. Projenizin Sayfa Yayımla özelliği, ClickOnce uygulamanız için Web sayfası için bir ad belirtmenize olanak tanır.

Yayımlama sayfası belirtildikten sonra, bir sonraki yayımlayışınızda, yayımlama konumuna kopyalanır; yeniden yayımladığınızda üzerine yazılmaz. Sayfanın görünümünü özelleştirmek isterseniz, değişikliklerinizi kaybetme konusunda endişelenmeden bunu yapabilirsiniz. Daha fazla bilgi için bkz . ClickOnce varsayılan Web sayfasını özelleştirme.

SayfaYı Yayımla özelliği, Proje Tasarımcısı'nın Yayımla bölmesinden erişilebilen Yayımlama Seçenekleri iletişim kutusunda ayarlanabilir.

ClickOnce uygulaması için özel bir Web sayfası belirtmek için:

  1. Çözüm Gezgini'de bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla bölmesini seçin.

  3. Yayımlama Seçenekleri iletişim kutusunu açmak için Seçenekler düğmesine tıklayın.

  4. Dağıtım'a tıklayın.

  5. Yayımlama Seçenekleri iletişim kutusunda, Yayımlamadan sonra dağıtım web sayfasını aç onay kutusunun seçili olduğundan emin olun (varsayılan olarak seçili olmalıdır).

  6. Dağıtım web sayfası kutusuna Web sayfanızın adını girin ve Tamam'a tıklayın.

Yayımla sayfasının her yayımladığınızda başlatılmasını önlemek için:

  1. Çözüm Gezgini'de bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla bölmesini seçin.

  3. Yayımlama Seçenekleri iletişim kutusunu açmak için Seçenekler düğmesine tıklayın.

  4. Dağıtım'a tıklayın.

  5. Yayımlama Seçenekleri iletişim kutusunda, Yayımlamadan sonra dağıtım web sayfasını aç onay kutusunu temizleyin.

ClickOnce uygulaması için varsayılan Web sayfasını özelleştirme

Bir ClickOnce uygulamasını Web'de yayımlarken, uygulamayla birlikte otomatik olarak bir Web sayfası oluşturulur ve yayımlanır. Varsayılan sayfa uygulamanın adını ve uygulamayı yüklemek, önkoşulları yüklemek veya MSDN'de yardıma erişmek için bağlantılar içerir.

Not

Sayfada gördüğünüz gerçek bağlantılar, sayfanın görüntülendiği bilgisayara ve hangi önkoşulları eklediğinize bağlıdır.

Web sayfasının varsayılan adı Publish.htm; adı Proje Tasarımcısı'nda değiştirebilirsiniz. Daha fazla bilgi için bkz . ClickOnce uygulaması için yayımlama sayfası belirtme.

Publish.htm Web sayfası yalnızca daha yeni bir sürüm algılanırsa yayımlanır.

Not

Yayımlama ayarlarınızda yaptığınız değişiklikler Publish.htm sayfasını etkilemez; tek bir özel durum vardır: İlk yayımlamadan sonra önkoşulları ekler veya kaldırırsanız, önkoşul listesi artık doğru olmaz. Önkoşul bağlantısının metnini değişiklikleri yansıtacak şekilde düzenlemeniz gerekir.

Yayımlama Web sayfasını özelleştirmek için:

  1. ClickOnce uygulamanızı bir Web konumunda yayımlayın. Daha fazla bilgi için bkz . Nasıl yapılır: Yayımlama Sihirbazı'nı kullanarak ClickOnce uygulaması yayımlama.

  2. Web sunucusunda, Publish.htm dosyasını Visual Web Designer'da veya başka bir HTML düzenleyicisinde açın.

  3. Sayfayı istediğiniz gibi özelleştirin ve kaydedin.

  4. isteğe bağlı. Visual Studio'un özelleştirilmiş yayımlama Web sayfanızın üzerine yazmasını önlemek için, Yayımlama Seçenekleri iletişim kutusundaki Her yayımlamadan sonra dağıtım Web sayfasını otomatik olarak oluştur seçeneğinin işaretini kaldırın.

ClickOnce uygulamasını yayımlarken Destek URL'si özelliği, kullanıcıların uygulama hakkında bilgi almak için gidebileceği bir Web sayfası veya dosya paylaşımı tanımlar. Bu özellik isteğe bağlıdır; sağlanırsa, URL uygulamanın Program Ekle veya Kaldır iletişim kutusunda görüntülenir.

Destek URL'si özelliği, Proje Tasarımcısı'nın Yayımla sayfasında ayarlanabilir.

Destek URL'si belirtmek için:

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Yayımlama Seçenekleri iletişim kutusunu açmak için Seçenekler düğmesine tıklayın.

  4. Açıklama'ya tıklayın.

  5. Destek URL'si alanına Bir Web sitesinin, Web sayfasının veya UNC paylaşımının tam yolunu girin.

ClickOnce dağıtımında tek tek önkoşullar için destek URL'si belirtme

ClickOnce dağıtımı, ClickOnce uygulamasının çalışması için istemci bilgisayarda bulunması gereken bir dizi önkoşulu test edebilir. Bu bağımlılıklar.NET Framework'ün gerekli en düşük sürümünü, işletim sisteminin sürümünü ve genel derleme önbelleğine (GAC) önceden yüklenmesi gereken tüm derlemeleri içerir. Ancak ClickOnce bu önkoşulların hiçbirini yükleyemiyor; bir önkoşul bulunamazsa, yalnızca yüklemeyi durdurur ve yüklemenin neden başarısız olduğunu açıklayan bir iletişim kutusu görüntüler.

Önkoşulları yüklemek için iki yöntem vardır. Bunları bir önyükleyici uygulaması kullanarak yükleyebilirsiniz. Alternatif olarak, tek tek önkoşullar için bir destek URL'si belirtebilirsiniz. Bu URL, önkoşul bulunamazsa iletişim kutusundaki kullanıcılara görüntülenir. Bu URL tarafından başvuruda bulunulmuş sayfa, gerekli önkoşulu yüklemeye yönelik yönergelerin bağlantılarını içerebilir. Bir uygulama tek bir önkoşul için destek URL'si belirtmezse, ClickOnce uygulamanın dağıtım bildiriminde belirtilen destek URL'sini tanımlanmışsa bir bütün olarak görüntüler.

Visual Studio, Mage.exe ve MageUI.exe tümü ClickOnce dağıtımları oluşturmak için kullanılabilir ancak bu araçların hiçbiri tek tek önkoşullar için destek URL'si belirtmeyi doğrudan desteklemez. Bu belgede, dağıtımınızın uygulama bildirimini ve dağıtım bildirimini bu destek URL'lerini içerecek şekilde nasıl değiştireceğiniz açıklanır.

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.

Tek bir önkoşul için destek URL'si belirtme

  1. ClickOnce uygulaması için uygulama bildirimini ( .manifest dosyası) bir metin düzenleyicisinde açın.

  2. İşletim sistemi önkoşulu için dependentOS özniteliğini supportUrl öğesine ekleyin:

     <dependency>
        <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
          <osVersionInfo>
            <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
          </osVersionInfo>
        </dependentOS>
      </dependency>
    
  3. Ortak dil çalışma zamanının belirli bir sürümünün önkoşulu için, ortak dil çalışma zamanı bağımlılığını belirten girişe özniteliğini dependentAssembly ekleyinsupportUrl:

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
          <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
        </dependentAssembly>
      </dependency>
    
  4. Genel derleme önbelleğine önceden yüklenmesi gereken bir derlemenin önkoşulu için, gerekli derlemeyi dependentAssembly belirten öğesini ayarlayınsupportUrl:

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
          <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
        </dependentAssembly>
      </dependency>
    
  5. isteğe bağlı. .NET Framework 4'i hedefleyen uygulamalar için ClickOnce uygulamasının dağıtım bildirimini (.application dosyası) bir metin düzenleyicisinde açın.

  6. .NET Framework 4 önkoşulu için özniteliğini compatibleFrameworks öğesine ekleyinsupportUrl:

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
      <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
      <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
    </compatibleFrameworks>
    
  7. Uygulama bildirimini el ile değiştirdikten sonra, dijital sertifikanızı kullanarak uygulama bildirimini yeniden imzalamanız, ardından dağıtım bildirimini de güncelleştirmeniz ve yeniden imzalamanız gerekir. Bu görevi gerçekleştirmek için Mage.exe veya MageUI.exe SDK araçlarını kullanın; visual studio kullanarak bu dosyaları yeniden oluşturma el ile yaptığınız değişiklikler silinir. Bildirimleri yeniden imzalamak için Mage.exe kullanma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Uygulama ve Dağıtım Bildirimlerini Yeniden İmzala.

.NET Framework güvenliği

Uygulama kısmi güven içinde çalışacak şekilde işaretlenmişse, iletişim kutusunda destek URL'si görüntülenmez.

ClickOnce uygulaması için yayımlama dilini değiştirme

ClickOnce uygulamasını yayımlarken, yükleme sırasında görüntülenen kullanıcı arabirimi varsayılan olarak geliştirme bilgisayarınızın diline ve kültürüne ayarlanır. Yerelleştirilmiş bir uygulama yayımlıyorsanız, yerelleştirilmiş sürümle eşleşecek bir dil ve kültür belirtmeniz gerekir. Bu, projenizin özelliği tarafından Publish language belirlenir.

Özellik, Publish language Proje Tasarımcısı'nın Yayımla sayfasından erişilebilen Yayımlama Seçenekleri iletişim kutusunda ayarlanabilir.

Not

Gördüğünüz iletişim kutuları ve menü komutları, etkin ayarlarınıza ve ürün sürümüne bağlı olarak Yardım menüsünde açıklanana göre farklılık gösterebilir. Ayarlarınızı değiştirmek için Araçlar menüsünde ayarları içeri ve dışarı aktar'ı seçin. Daha fazla bilgi için bkz . Ayarları sıfırlama.

Yayımlama dilini değiştirmek için:

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

    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.

  3. Yayımlama Seçenekleri iletişim kutusunu açmak için Seçenekler düğmesine tıklayın.

  4. Açıklama'ya tıklayın.

  5. Yayımlama Seçenekleri iletişim kutusunda, Yayımlama dili açılan listesinden bir dil ve kültür seçin ve tamam'a tıklayın.

ClickOnce uygulaması için Başlat menüsü adı belirtme

Bir ClickOnce uygulaması hem çevrimiçi hem de çevrimdışı kullanım için yüklendiğinde, Başlat menüsüne ve Program Ekle veya Kaldır listesine bir girdi eklenir. Varsayılan olarak, görünen ad uygulama derlemesinin adıyla aynıdır, ancak Yayımlama Seçenekleri iletişim kutusunda Ürün adı'nı ayarlayarak görünen adı değiştirebilirsiniz.

Ürün adı, publish.htm sayfasında görüntülenir; yüklü bir çevrimdışı uygulama için, Başlat menüsündeki girdinin adı ve Program Ekle veya Kaldır'da gösterilen ad da olacaktır.

Yayımcı adı, Ürün adı'nınüzerindeki publish.htm sayfasında görünür ve yüklü bir çevrimdışı uygulama için, Başlat menüsünde uygulamanın simgesini içeren klasörün adı da olur.

Başlat menüsü kısayolu veya uygulama başvurusu %appdata%\Microsoft\Windows\Start Menu\Programs\<publisher name> konumunda oluşturulur. Kısayol veya uygulama başvurusu, ürün adıyla aynı ada sahiptir.

Proje Tasarımcısı'nın Yayımla sayfasında bulunan Yayımlama Seçenekleri iletişim kutusunda Ürün adı ve Yayımcı adı özelliklerini ayarlayabilirsiniz.

Başlat menüsü adı belirtmek için:

  1. Çözüm Gezgini'da bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Yayımlama Seçenekleri iletişim kutusunu açmak için Seçenekler düğmesine tıklayın.

  4. Açıklama'ya tıklayın.

  5. Yayımlama Seçenekleri iletişim kutusunda, Ürün adı'nda görüntülenecek adı girin.

  6. İsteğe bağlı olarak, Publisher adına bir yayımcı adı girebilirsiniz.

CD yüklemeleri için Otomatik Başlangıç'i etkinleştirme

ClickOnce uygulamasını CD-ROM veya DVD-ROM gibi çıkarılabilir medya aracılığıyla dağıtırken, medya eklendiğinde ClickOnce uygulamasının otomatik olarak başlatılmasını sağlayabilirsiniz AutoStart .

AutoStart, Proje Tasarımcısı'nın Yayımla sayfasında etkinleştirilebilir.

Otomatik Başlangıç'ı etkinleştirmek için:

  1. Çözüm Gezgini'de bir proje seçiliyken, Proje menüsünde Özellikler'e tıklayın.

  2. Yayımla sekmesine tıklayın.

  3. Seçenekler düğmesine tıklayın.

    Yayımlama Seçenekleri iletişim kutusu görüntülenir.

  4. Dağıtım'a tıklayın.

  5. CD yüklemeleri için, CD eklendiğinde Kurulumu otomatik olarak başlat onay kutusunu seçin.

    Uygulama yayımlandığında autorun.inf dosyası yayımlama konumuna kopyalanır.