Share via


ClickOnce kullanarak Office çözümü dağıtma

ClickOnce kullanıyorsanız Office çözümünüzü daha az adımda dağıtabilirsiniz. Güncelleştirmeleri yayımlarsanız, çözümünüz bunları otomatik olarak algılar ve yükler. Bununla birlikte, ClickOnce, çözümünüzü bir bilgisayarın her kullanıcısı için ayrı ayrı yüklemenizi gerektirir. Bu nedenle, çözümünüzü aynı bilgisayarda birden fazla kullanıcı çalıştıracaksa Windows Installer 'ı (.msi) kullanmayı düşünmelisiniz.

Bu konuda,

Çözümü yayımlama

Yayımlama Sihirbazı'nı veya Project Tasarım Aracı kullanarak çözümünüzü yayımlayabilirsiniz. Bu yordamda Project Tasarım Aracı kullanacaksınız çünkü tüm yayımlama seçeneklerini sağlar. Bkz. Yayımlama sihirbazı (Visual Studio'da Office geliştirme).

Çözümü yayımlamak için

  1. Çözüm Gezgini'da projeniz için adlandırılan düğümü seçin.

  2. Menü çubuğunda Proje, ProjectNameÖzellikleri'ni seçin.

  3. Proje Tasarım Aracı, aşağıdaki çizimde gösterilen Yayımla sekmesini seçin.

    The publish tab of the Project Designer

  4. Yayımlama Klasörü Konumu (ftp sunucusu veya dosya yolu) kutusuna Project Tasarım Aracı'nin çözüm dosyalarını kopyalamasını istediğiniz klasörün yolunu girin.

    Aşağıdaki yol türlerinden herhangi birini girebilirsiniz.

    • Yerel bir yol (örneğin, C:\KlasörAdı\KlasörAdı).

    • Ağınızdaki bir klasörün Tekdüzen Adlandırma Kuralı (UNC) yolu (örneğin, \\SunucuAdı\KlasörAdı).

    • Göreli bir yol (örneğin, projenin varsayılan olarak yayımlandığı klasör olan PublishFolder\).

  5. Yükleme Klasörü URL'si kutusuna, son kullanıcıların çözümünüzü bulacağı konumun tam yolunu girin.

    Konumu henüz bilmiyorsanız, bu alana hiçbir şey girmeyin. Varsayılan olarak, ClickOnce, kullanıcılarınızın çözümü yüklediği klasörde güncelleştirmeleri arar.

  6. Önkoşullar düğmesini seçin.

  7. Önkoşullar iletişim kutusunda, Önkoşul bileşenlerini yüklemek için kurulum programı oluştur onay kutusunun seçili olduğundan emin olun.

  8. Hangi önkoşulların yükleneceğini seçin listesinde Windows Installer 4.5 ve uygun .NET Framework paketinin onay kutularını seçin.

    Örneğin, çözümünüz .NET Framework 4.5'i hedef alıyorsa Windows Installer 4.5 ve Microsoft .NET Framework 4.5 Full onay kutularını seçin.

  9. Çözümünüz .NET Framework 4.5'i hedef alıyorsa, Office Çalışma Zamanı için Visual Studio 2010 Araçları onay kutusunu da seçin.

    Not

    Varsayılan olarak, bu onay kutusu görünmez. Bu onay kutusunu göstermek için bir Önyükleyici paketi oluşturmanız gerekir. Bkz . Visual Studio 2012 ile Office 2013 VSTO Eklentisi için Önyükleyici paketi oluşturma.

  10. Önkoşullar için yükleme konumunu belirtin altında, görüntülenen seçeneklerden birini belirleyin ve ardından Tamam düğmesini seçin.

    Aşağıdaki tabloda her bir seçenek açıklanmaktadır.

    Seçenek Açıklama
    Bileşen satıcısının web sitesinden önkoşulları indirme Kullanıcıdan, bu önkoşulları satıcının sitesinden indirmesi ve yüklemesi istenir.
    Önkoşulları uygulamamla aynı konumdan indirme Önkoşul yazılımı çözümle birlikte yüklenir. Bu seçeneği tercih ederseniz, Visual Studio sizin için önkoşul paketlerinin tümünü yayımlama konumuna kopyalar. Bu seçeneğin çalışması için önkoşul paketleri geliştirme bilgisayarında olmalıdır.
    Önkoşulları aşağıdaki konumdan indirin Visual Studio tüm önkoşul paketlerini belirttiğiniz konuma kopyalar ve bunları çözümle birlikte yükler.

    Bkz . Önkoşullar iletişim kutusu.

  11. Güncelleştirmeler düğmesini seçin, her son kullanıcının VSTO Eklentisinin veya özelleştirmesinin güncelleştirmeleri denetleme sıklıklarını belirtin ve ardından Tamam düğmesini seçin.

    Not

    CD veya çıkarılabilir bir sürücü kullanarak dağıtıyorsanız Güncelleştirmeleri hiçbir zaman denetleme seçeneği düğmesini seçin.

    Güncelleştirme yayımlama hakkında bilgi için bkz . Güncelleştirme yayımlama.

  12. Seçenekler düğmesini seçin, Seçenekler iletişim kutusundaki seçenekleri gözden geçirin ve ardından Tamam düğmesini seçin.

  13. Şimdi Yayımla düğmesini seçin.

    Visual Studio, bu yordamda daha önce belirttiğiniz yayımlama klasörüne aşağıdaki klasörleri ve dosyaları ekler.

    • Uygulama Dosyaları klasörü.

    • Kurulum programı.

    • En son sürümün dağıtım bildirimine işaret eden bir dağıtım bildirimi.

      Uygulama Dosyaları klasörü, yayımladığınız her sürüm için bir alt klasör içerir. Her bir sürüme özgü alt klasörde aşağıdaki dosyalar bulunur.

    • Uygulama bildirimi.

    • Dağıtım bildirimi.

    • Özelleştirme derlemeleri.

      Aşağıdaki çizimde, Bir Outlook VSTO Eklentisi için yayımlama klasörünün yapısı gösterilmektedir.

      Publish Folder Structure

    Not

    ClickOnce, güvenli olmayan bir uzantı nedeniyle Internet Information Services'ın (IIS) güvenli bir yüklemesinin dosyaları engellememesi için .deploy uzantısını derlemelere ekler. Kullanıcı çözümü yüklediğinde ClickOnce .deploy uzantısını kaldırır.

  14. Çözüm dosyalarını, bu yordamda daha önce belirttiğiniz yükleme konumuna kopyalayın.

Çözüme nasıl güven vermek istediğinize karar verme

Bir çözümün kullanıcı bilgisayarları üzerinde çalışması için önce, sizin güven kazandırmanız ya da kullanıcıların çözümü yükledikleri sırada bir güvenlik istemine yanıt vermeleri gerekir. Çözüme güven kazandırmak için, bilinen ve güvenilir bir yayımcıyı tanımlayan bir sertifika kullanarak bildirimleri imzalayın. Bkz . Uygulama ve dağıtım bildirimlerini imzalayarak çözüme güvenme.

Belge düzeyinde özelleştirme dağıtıyorsanız ve belgeyi kullanıcının bilgisayarındaki bir klasöre yerleştirmek veya belgeyi bir SharePoint sitesinde kullanılabilir hale getirmek istiyorsanız, Office'in belgenin konumuna güvendiğinden emin olun. Bkz. Belgelere güven verme.

Kullanıcıların çözümü yüklemesine yardımcı olun

Kullanıcılar kurulum programını çalıştırarak, dağıtım bildirimini açarak veya belge düzeyinde özelleştirme sırasında belgeyi doğrudan açarak çözümü yükleyebilir. En iyi uygulama olarak, kullanıcılar çözümünüzü kurulum programını kullanarak yüklemelidir. Diğer iki yaklaşım önkoşul yazılımının yüklü olduğundan emin değildir. Kullanıcılar belgeyi yükleme konumundan açmak isterse, Office uygulamasının Güven Merkezi'nde bu konumu güvenilir konumlar listesine eklemeleri gerekir.

Belge düzeyinde bir özelleştirmenin belgesini açma

Kullanıcılar, belge düzeyinde bir özelleştirmenin belgesini doğrudan yükleme konumundan açabilirler veya belgeyi kendi yerel bilgisayarlarına kopyalayıp sonra bu kopyayı açabilirler.

En iyi uygulama olarak, kullanıcılar belgenin bir kopyasını kendi bilgisayarlarında açmalıdır; böylece birden fazla kullanıcı aynı anda aynı kopyayı açmaya çalışmaz. Bu uygulamayı zorunlu tutmak için, kurulum programınızı, belgeyi kullanıcı bilgisayarlarına kopyalayacak şekilde yapılandırabilirsiniz. Bkz . Çözüm belgesini son kullanıcının bilgisayarına yerleştirme (yalnızca belge düzeyinde özelleştirmeler).

Bir IIS web sitesinden dağıtım bildirimini açarak çözümü yükleyin

Kullanıcılar, web'ten dağıtım bildirimini açmak suretiyle bir Office çözümünü yükleyebilirler. Ancak, Internet Information Services'ın (IIS) güvenli bir yüklemesi .vsto uzantısına sahip dosyaları engeller. Bir Office çözümünü IIS kullanarak dağıtabilmeniz için önce MIME türü IIS'de tanımlanmalıdır.

IIS 6.0'a .vsto MIME türünü eklemek için
  1. IIS 6.0 çalıştıran sunucuda Tüm Programları> Başlat>Yönetici Istrative Tools>Internet Information Services (IIS) Yöneticisi'ni seçin.

  2. Bilgisayar adını, Web Siteleri klasörünü veya yapılandırdığınız web sitesini seçin.

  3. Menü çubuğunda Eylem>Özellikleri'ni seçin.

  4. HTTP Üst Bilgileri sekmesinde MIME Türleri düğmesini seçin.

  5. MIME Türleri penceresinde Yeni düğmesini seçin.

  6. MIME Türü penceresinde uzantı olarak .vsto girin, MIME türü olarak application/x-ms-vsto girin ve yeni ayarları uygulayın.

    Not

    Değişikliklerin etkili olması için, World Wide Web Yayımlama Hizmeti'ni yeniden başlatmalı veya çalışan işleminin tekrar geri dönmesini beklemelisiniz. Ardından tarayıcının disk önbelleğini temizlemeniz ve .vsto dosyasını yeniden açmayı denemeniz gerekir.

IIS 7.0'a .vsto MIME türünü eklemek için
  1. IIS 7.0 çalıştıran sunucuda Tüm Program Donatılarını> Başlat'ı>seçin.

  2. Komut İstemi için kısayol menüsünü açın ve yönetici olarak çalıştır'ı seçin.

  3. kutusuna aşağıdaki yolu girin ve tamam düğmesini seçin.

    %windir%\system32\inetsrv
    
  4. Aşağıdaki komutu girin ve ardından yeni ayarları uygulayın.

    set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
    

    Not

    Değişikliklerin etkili olması için, World Wide Web Yayımlama Hizmeti'ni yeniden başlatmalı veya çalışan işleminin tekrar geri dönmesini beklemelisiniz. Ardından tarayıcının disk önbelleğini temizlemeniz ve .vsto dosyasını yeniden açmayı denemeniz gerekir.

Çözüm belgesini son kullanıcının bilgisayarına yerleştirme (yalnızca belge düzeyinde özelleştirmeler)

Dağıtım sonrası eylem oluşturarak çözümünüzün belgesini son kullanıcının bilgisayarına kopyalayabilirsiniz. Bu şekilde, kullanıcının çözümünüzü yükledikten sonra belgeyi yükleme konumundan bilgisayarına el ile kopyalaması gerekmez. Dağıtım sonrası eylemi tanımlayan bir sınıf oluşturmanız, çözümü derleyip yayımlamanız, uygulama bildirimini değiştirmeniz ve uygulama ve dağıtım bildirimini yeniden imzalamanız gerekir.

Aşağıdaki yordamlarda proje adınızın ExcelWorkbook olduğu ve çözümü bilgisayarınızda C:\publish adlı oluşturulmuş bir klasörde yayımladığınız varsayılır.

Dağıtım sonrası eylemi tanımlayan bir sınıf oluşturma

  1. Menü çubuğunda Dosya>Yeni Proje Ekle'yi>seçin.

  2. Yeni Proje Ekle iletişim kutusundaki Yüklü Şablonlar bölmesinde Windows klasörünü seçin.

  3. Şablonlar bölmesinde Sınıf Kitaplığı şablonunu seçin.

  4. Ad alanına FileCopyPDA yazın ve Tamam düğmesini seçin.

  5. Çözüm Gezgini'da FileCopyPDA projesini seçin.

  6. Menü çubuğunda Proje>Başvuru Ekle'yi seçin.

  7. .NET sekmesinde ve Microsoft.VisualStudio.Tools.Applications.ServerDocumentöğesine Microsoft.VisualStudio.Tools.Applications.Runtime başvurular ekleyin.

  8. sınıfını FileCopyPDAolarak yeniden adlandırın ve dosyanın içeriğini kodla değiştirin. Bu kod aşağıdaki görevleri gerçekleştirir:

    • Belgeyi kullanıcının masaüstüne kopyalar.

    • _AssemblyLocation özelliğini göreli bir yoldan dağıtım bildirimi için tam yol olarak değiştirir.

    • Kullanıcı çözümü kaldırırsa, dosyayı siler.

      using Microsoft.VisualStudio.Tools.Applications.Deployment;
      using Microsoft.VisualStudio.Tools.Applications;
      using System.IO;
      
      namespace FileCopyPDA
      {
          public class FileCopyPDA : IAddInPostDeploymentAction
          {
              public void Execute(AddInPostDeploymentActionArgs args) 
              {
                  string dataDirectory = @"Data\ExcelWorkbook.xlsx";
                  string file = @"ExcelWorkbook.xlsx";
                  string sourcePath = args.AddInPath;
                  Uri deploymentManifestUri = args.ManifestLocation;
                  string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
                  string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
                  string destFile = System.IO.Path.Combine(destPath, file);
      
                  switch (args.InstallationStatus)
                  {
                      case AddInInstallationStatus.InitialInstall:
                      case AddInInstallationStatus.Update:
                          File.Copy(sourceFile, destFile);
                          ServerDocument.RemoveCustomization(destFile);
                          ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                          break;
                      case AddInInstallationStatus.Uninstall:
                          if (File.Exists(destFile))
                          {
                              File.Delete(destFile);
                          }
                          break;
                  }
              }
          }
      }
      

Çözümü derleme ve yayımlama

  1. Çözüm Gezgini'da FileCopyPDA projesinin kısayol menüsünü açın ve ardından Oluştur'u seçin.

  2. ExcelWorkbook projesinin kısayol menüsünü açın ve ardından Oluştur'u seçin.

  3. ExcelWorkbook projesinin kısayol menüsünü açın ve ardından Başvuru Ekle'yi seçin.

  4. Başvuru Ekle iletişim kutusunda Projeler sekmesini seçin, FileCopyPDA'yı ve ardından Tamam düğmesini seçin.

  5. Çözüm Gezgini ExcelWorkbook projesini seçin.

  6. Menü çubuğunda Yeni Klasör Projele'yi>seçin.

  7. Veri girin ve Enter tuşunu seçin.

  8. Çözüm Gezgini'da Veri klasörünü seçin.

  9. Menü çubuğunda Proje>Varolan Öğe Ekle'yi seçin.

  10. Varolan Öğe Ekle iletişim kutusunda, ExcelWorkbook projesinin çıkış dizinine gidin, ExcelWorkbook.xlsx dosyasını seçin ve ardından Ekle düğmesini seçin.

  11. Çözüm Gezgini ExcelWorkbook.xlsx dosyasını seçin.

  12. Özellikler penceresinde Derleme Eylemi özelliğini İçerik olarak, Çıktı Dizinine Kopyala özelliğini ise daha yeniyse Kopyala olarak değiştirin.

    Bu adımları tamamladığınızda, projeniz aşağıdaki çizime benzer.

    Project structure of the post deployment action.

  13. ExcelWorkbook projesini yayımlayın.

Uygulama bildiriminde değişiklik yapma

  1. Dosya Gezgini kullanarak c:\publish çözüm dizinini açın.

  2. Uygulama Dosyaları klasörünü açın ve ardından çözümünüzün en son yayımlanan sürümüne karşılık gelen klasörü açın.

  3. ExcelWorkbook.dll.manifest dosyasını Not Defteri gibi bir metin düzenleyicisinde açın.

  4. öğesinden </vstav3:update> sonra aşağıdaki kodu ekleyin. öğesinin sınıf özniteliği <vstav3:entryPoint> için şu söz dizimini kullanın: NamespaceName.ClassName. Aşağıdaki örnekte ad alanı ve sınıf adları aynıdır, dolayısıyla sonuçta elde edilen giriş noktası adı olur FileCopyPDA.FileCopyPDA.

    <vstav3:postActions>
      <vstav3:postAction>
        <vstav3:entryPoint
          class="FileCopyPDA.FileCopyPDA">
          <assemblyIdentity
            name="FileCopyPDA"
            version="1.0.0.0"
            language="neutral"
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:postActionData>
        </vstav3:postActionData>
      </vstav3:postAction>
    </vstav3:postActions>
    

Uygulama ve dağıtım bildirimlerini yeniden imzalama

  1. %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook klasöründe ExcelWorkbook_TemporaryKey.pfx sertifika dosyasını kopyalayın ve PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion klasörüne yapıştırın.

  2. Visual Studio komut istemini açın ve ardından dizinleri c:\publish\Application Files\ExcelWorkbook_MostRecentPublishedVersion klasörüne (örneğin, c:\publish\Application Files\ExcelWorkbook_1_0_0_4) değiştirin.

  3. Aşağıdaki komutu çalıştırarak değiştirilmiş uygulama bildirimini imzalayın:

    mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
    

    "ExcelWorkbook.dll.manifest başarıyla imzalandı" iletisi görüntülenir.

  4. c:\publish klasörüne geçin ve aşağıdaki komutu çalıştırarak dağıtım bildirimini güncelleştirin ve imzalayın:

    mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
    celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
    

    Not

    Önceki örnekte MostRecentVersionNumber değerini çözümünüzün en son yayımlanan sürümünün sürüm numarasıyla değiştirin (örneğin, 1_0_0_4).

    "ExcelWorkbook.vsto başarıyla imzalandı" iletisi görüntülenir.

  5. ExcelWorkbook.vsto dosyasını c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber dizinine kopyalayın.

Çözüm belgesini SharePoint çalıştıran bir sunucuya yerleştirin (yalnızca belge düzeyinde özelleştirmeler)

Belge düzeyinde özelleştirmenizi SharePoint kullanarak son kullanıcılara yayımlayabilirsiniz. Kullanıcılar SharePoint sitesine gidip belgeyi açtığında, çalışma zamanı çözümü paylaşılan ağ klasöründen kullanıcının yerel bilgisayarına otomatik olarak yükler. Çözüm yerel olarak yüklendikten sonra, belge başka bir yere (örneğin, masaüstüne) kopyalansa bile özelleştirme işlevini yerine getirmeye devam eder.

Belgeyi SharePoint çalıştıran bir sunucuya koymak için

  1. Çözüm belgesini SharePoint sitesindeki bir belge kitaplığına ekleyin.

  2. Aşağıdaki yaklaşımlardan biri için adımları uygulayın:

    • SharePoint çalıştıran sunucuyu, tüm bilgisayarlarda Word veya Excel'deki Güven Merkezi'ne eklemek için Office Yapılandırma Aracı'nı kullanın.

      Bkz. Office 2010'da güvenlik ilkeleri ve ayarları.

    • Her kullanıcının aşağıdaki adımları uygulamasını sağlayın.

      1. Yerel bilgisayarda Word veya Excel'i açın, Dosya sekmesini seçin ve ardından Seçenekler düğmesini seçin.

      2. Güven Merkezi iletişim kutusunda Güvenilen Konumlar düğmesini seçin.

      3. Ağımda Güvenilen Konumlara İzin Ver (önerilmez) onay kutusunu seçin ve ardından Yeni konum ekle düğmesini seçin.

      4. Yol kutusuna, karşıya yüklediğiniz belgeyi içeren SharePoint belge kitaplığının URL'sini girin (örneğin, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        Varsayılan Web sayfasının adını (default.aspx veya AllItems.aspx gibi) eklemeyin.

      5. Bu konumun alt klasörleri de güvenilir onay kutusunu seçin ve ardından Tamam düğmesini seçin.

        Kullanıcılar belgeyi SharePoint sitesinden açtığında, belge açılır ve özelleştirme yüklenir. Kullanıcılar belgeyi kendi masaüstlerine kopyalayabilir. Belgedeki özellikler belgenin ağ konumuna işaret ettiğinden, özelleştirme çalışmaya devam edecektir.

Özel bir yükleyici oluşturma

Çözümü yayımladığınızda sizin için oluşturulan kurulum programını kullanmak yerine Office çözümünüz için özel bir yükleyici oluşturabilirsiniz. Örneğin, yüklemeyi başlatmak için bir oturum açma betiği kullanabilir veya çözümü kullanıcı etkileşimi olmadan yüklemek için bir toplu iş dosyası kullanabilirsiniz. Bu senaryolar en çok, önkoşullar son kullanıcı bilgisayarlarında zaten yüklü olduğunda işe yarar.

Özel yükleme işleminizin bir parçası olarak, varsayılan olarak aşağıdaki konuma yüklenen Office çözümleri için yükleyici aracını (VSTOInstaller.exe) çağırın:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Araç bu konumda değilse, o aracın yolunu bulmak için HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath veya HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath kayıt defteri anahtarını kullanabilirsiniz.

VSTOinstaller.exe ile aşağıdaki parametreleri kullanabilirsiniz.

Parametre Açıklama
/Install veya /I Çözümü yükler. Bu seçeneğin ardından bir dağıtım bildiriminin konumunu vermelisiniz. Yerel bilgisayarda evrensel adlandırma kuralı (UNC) dosya paylaşımı olan bir yol belirtebilirsiniz. Yerel yol (C:\FolderName\PublishFolder), göreli yol (Yayımla\) veya tam konum (\\SunucuAdı\KlasörAdı veya http:// SunucuAdı/KlasörAdı) belirtebilirsiniz.
/Uninstall veya /U Çözümü kaldırır. Bu seçeneğin ardından bir dağıtım bildiriminin konumunu vermelisiniz. Bir yolun yerel bilgisayarda, bir UNC dosya paylaşımında olabileceğini belirtebilirsiniz. Yerel yol (c:\FolderName\PublishFolder), göreli yol (Publish\) veya tam konum (\\ServerName\FolderName veya http:// ServerName/FolderName) belirtebilirsiniz.
/Silent veya /S Kullanıcıdan bir şey girmesini istemeden veya ileti görüntülemeden yükler veya kaldırır. Güven istemi gerekiyorsa özelleştirme yüklenmez veya güncelleştirilmez.
/Help or /? Yardım bilgilerini görüntüler.

VSTOinstaller.exe dosyasını çalıştırdığınızda aşağıdaki hata kodları görüntülenebilir.

Hata Kodu Açıklama
0 Çözüm başarıyla yüklendi ya da kaldırıldı veya VSTOInstaller Yardımı görüntülendi.
-100 Bir veya daha fazla komut satırı seçeneği geçerli değil veya birden çok kez ayarlandı. Daha fazla bilgi için "vstoinstaller /?" girin veya bkz . ClickOnce Office çözümü için özel yükleyici oluşturma.
-101 Bir veya daha fazla komut satırı seçeneği geçerli değil. Daha fazla bilgi için "vstoinstaller /?" girin.
-200 Dağıtım bildirimi URI'si geçerli değil. Daha fazla bilgi için "vstoinstaller /?" girin.
-201 Dağıtım bildirimi geçerli olmadığından çözüm yüklenemedi. Bkz. Office çözümleri için dağıtım bildirimleri.
-202 Uygulama bildiriminin Office için Visual Studio Araçları bölümü geçerli olmadığından çözüm yüklenemedi. Bkz. Office çözümleri için uygulama bildirimleri.
-203 Bir indirme hatası oluştuğundan çözüm yüklenemedi. Dağıtım bildiriminin URI'sini veya ağ dosya konumunu denetleyin ve sonra yeniden deneyin.
-300 Bir güvenlik özel durumu oluştuğundan çözüm yüklenemedi. Bkz. Güvenli Office çözümleri.
-400 Çözüm yüklenemedi.
-401 Çözüm kaldırılamıyor.
-500 Çözüm yüklenemediğinden ya da kaldırılamadığından veya dağıtım bildirimi indirilemediğinden işlem iptal edildi.

Güncelleştirme yayımlama

Bir çözümü güncelleştirmek için Project Tasarım Aracı veya Yayımlama Sihirbazı'nı kullanarak çözümü yeniden yayımlar ve ardından güncelleştirilmiş çözümü yükleme konumuna kopyalarsınız. Dosyaları yükleme konumuna kopyalarken, önceki dosyaların üzerine yazdığınızdan emin olun.

Çözüm bir sonraki güncelleştirme denetiminde yeni sürümü otomatik olarak bulur ve yükler.

Çözümün yükleme konumunu değiştirme

Bir çözüm yayımlandıktan sonra yükleme yolunu ekleyebilir veya değiştirebilirsiniz. Yükleme yolunu değiştirmek istemenizin nedeni şunlardan biri veya daha fazlası olabilir:

  • Kurulum programı, henüz yükleme yolu bilinmezken derlenmiştir.

  • Çözüm dosyaları farklı bir konuma kopyalanmıştır.

  • Yükleme dosyalarını barındıran sunucu yeni bir ada veya konuma sahiptir.

    Bir çözümün yükleme yolunu değiştirmek için kurulum programını güncelleştirmelisiniz; daha sonra da kullanıcıların bunu çalıştırması gerekir. Belge düzeyinde özelleştirmeler için, kullanıcıların ayrıca belgelerindeki bir özelliği de yeni konuma işaret edecek şekilde güncelleştirmeleri gerekir.

Not

Kullanıcılardan belge özelliklerini güncelleştirmelerini istemiyorsanız, kullanıcılardan güncelleştirilmiş belgeyi yükleme konumundan almalarını isteyebilirsiniz.

Kurulum programındaki yükleme konumunu değiştirmek için

  1. Bir Komut İstemi penceresi açın ve dizinleri yükleme klasörüne değiştirin.

  2. Kurulum programını çalıştırın ve yeni yükleme yolunu dize olarak alan parametresini ekleyin /url .

    Aşağıdaki örnekte, Fabrikam web sitesindeki bir konumun yükleme yolunun nasıl değiştirileceği gösterilmektedir; ancak siz bu URL'yi istediğiniz yol ile değiştirebilirsiniz:

    setup.exe /url="http://www.fabrikam.com/newlocation"
    

    Not

    Bir ileti ekrana gelir ve yürütülebilir öğenin imzasının geçersiz kılınacağını belirtirse, çözümü imzalamak için kullanılan sertifika artık geçerli değil ve yayımcısı bilinmiyor demektir. Sonuç olarak, kullanıcıların, çözümü yüklemeden önce çözümün kaynağına güvendiklerini onaylamaları gerekecektir.

    Not

    URL'nin geçerli değerini görüntülemek için komutunu çalıştırın setup.exe /url.

    Belge düzeyi özelleştirmeleri için kullanıcıların belgeyi açması ve ardından _AssemblyLocation özelliğini güncelleştirmesi gerekir. Aşağıdaki adımlarda kullanıcıların bu görevi nasıl yerine getirecekleri açıklanmaktadır.

Bir belgede _AssemblyLocation özelliğini güncelleştirmek için

  1. Dosya sekmesinde, aşağıdaki çizimde gösterilen Bilgi'yi seçin.

    Info tab in Excel

  2. Özellikler listesinde, aşağıdaki çizimde gösterilen Gelişmiş Özellikler'i seçin.

    Advanced Properties in Excel.

  3. Özellikler listesindeki Özel sekmesinde, aşağıdaki çizimde gösterildiği gibi _AssemblyLocation seçin.

    The AssemblyLocation property.

    Değer kutusu dağıtım bildirimi tanımlayıcısını içerir.

  4. Tanımlayıcıdan önce, belgenin tam yolunu ve ardından Yol|Tanımlayıcısı biçiminde bir çubuk girin (örneğin, File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

    Bu tanımlayıcıyı biçimlendirme hakkında daha fazla bilgi için bkz . Özel belge özelliklerine genel bakış.

  5. Tamam düğmesini seçin ve belgeyi kaydedip kapatın.

  6. Çözümü belirtilen konuma yüklemek için, kurulum programını /url parametresi olmadan çalıştırın.

Çözümü önceki bir sürüme geri alma

Bir çözümü geri aldığınızda, kullanıcıları bu çözümün önceki bir sürümüne geri döndürmüş olursunuz.

Bir çözümü geri almak için

  1. Çözümün yükleme konumunu açın.

  2. Üst düzey yayımlama klasöründe dağıtım bildirimini ( .vsto dosyası) silin.

  3. Geri almak istediğiniz sürüme ait alt klasörü bulun.

  4. O alt klasördeki dağıtım bildirimini üst düzey publish klasörüne kopyalayın.

    Örneğin, 1.0.0.1 sürümünden 1.0.0.0 sürümüne OutlookAddIn1 adlı bir çözümü geri almak için, OutlookAddIn1_1_0_0_0 klasöründen OutlookAddIn1.vsto dosyasını kopyalayın. Dosyayı en üst düzey yayımlama klasörüne yapıştırın ve zaten orada olan OutlookAddIn1_1_0_0_1 için sürüme özgü dağıtım bildiriminin üzerine yazın.

    Aşağıdaki resimde, bu örnekteki publish (yayımlama) klasörü yapısı gösterilmektedir.

    Publish Folder Structure

    Kullanıcının uygulamayı ya da özelleştirilmiş belgeyi bir sonraki açışında, dağıtım bildirimindeki değişiklik algılanır. Office çözümünün önceki sürümü ClickOnce önbelleğinden çalışır.

Not

Yerel veriler çözümün sadece bir önceki sürümü için kaydedilir. İki sürümü geri alırsanız yerel veriler korunmaz. Yerel veriler hakkında daha fazla bilgi için bkz . ClickOnce uygulamalarında yerel ve uzak verilere erişme.