Aracılığıyla paylaş

Office çözümü dağıtımı sorunlarını giderme

  • Makale

Şunlar için geçerlidir: Visual Studio

Bu makalede, Office çözümlerini dağıtırken karşılaşabileceğiniz yaygın sorunların nasıl çözülebileceği anlatılır.

Bu makaledeki bilgiler belge düzeyi projeler ve Office için Visual Studio Araçları (VSTO) Eklenti projeleri için geçerlidir. Bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Olay görüntüleyicisini kullanarak Office çözümleriyle ilgili sorunları giderme

Office çözümlerini yüklediğinizde veya kaldırdığınızda Office için Visual Studio Araçları çalışma zamanı tarafından yakalanan hata iletilerini görmek için Windows'da olay görüntüleyicisini kullanabilirsiniz. Yükleme ve dağıtım sorunlarını çözmek için olay günlükçüsünden bu iletileri kullanabilirsiniz. Daha fazla bilgi için bkz . Office çözümleri için olay günlüğü.

Derleme adını değiştirmek çakışmalara neden oluyor

Zaten bir çözüm dağıttıktan sonra Project Tasarım AracıUygulama sayfasındaki Derleme Adı değerini değiştirirseniz, yayımlama araçları Kurulum paketini bir Setup.exe dosyası ve iki dağıtım bildirimi olacak şekilde değiştirir. İki bildirim dosyası dağıtırsanız aşağıdaki koşullar oluşabilir:

  • Son kullanıcı her iki sürümü de yüklerse, uygulama her iki VSTO Eklentisini de yükler.
  • VSTO Eklentisi derleme adı değiştirilmeden önce yüklendiyse, son kullanıcı hiçbir zaman güncelleştirme almaz.

Bu koşulları önlemek için, çözümü dağıttığınızda çözümün Derleme Adı değerini değiştirmeyin.

Güncelleştirmeleri denetleme işlemi uzun sürüyor

Office çalışma zamanı için Visual Studio 2010 Araçları, yöneticilerin bildirimleri ve çözümü indirmek için zaman aşımı değerini ayarlamak için kullanabileceği bir kayıt defteri girdisi sağlar.

Zaman aşımı değerini ayarlama

  1. Kayıt defterinde aşağıdaki anahtara gidin:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. AddInTimeout alt anahtarında zaman aşımı değerini milisaniye olarak ayarlayın.

    AddInTimeout alt anahtarı yoksa DWORD olarak oluşturun.

Ağ dosya paylaşımı güncelleştirilemiyor veya yayımılamıyor

Bir ağ dosya paylaşımındaki Office çözümleri, güncelleştirme yayımlanırken çözümün Setup.exe dosyası bir işlemde kilitliyse güncelleştirmeler sırasında yanıltıcı bir ileti görüntüleyebilir. İletide şu ifadeler yer alabilir: "Web'e 'setup.exe' eklenemiyor. 'setup.exe' dosyası bu Web'de zaten var."

Dosya kilitlemeyi önlemeye yardımcı olmak için paylaşımı son kullanıcılara salt okunur hale getirebilirsiniz. Ancak, belgeler paylaşımdaysa son kullanıcılar için de salt okunur hale gelir.

Microsoft Office önkoşulları yüklü değil

.NET Framework, Office için Visual Studio Araçları çalışma zamanını ve Office birincil birlikte çalışma derlemelerini, Office çözümünüzle dağıtılan önkoşullar olarak Kurulum paketinize ekleyebilirsiniz. Birincil birlikte çalışma derlemelerinin nasıl yükleneceği hakkında bilgi için bkz. Office çözümleri geliştirmek için bilgisayar yapılandırma ve Nasıl yapılır: Office birincil birlikte çalışma derlemelerini yükleme.

Localhost kullanarak yayımlama yükleme sorunlarına neden olabilir

Belge düzeyi çözümler için yayımlama veya yükleme konumu olarak kullandığınızda http://localhost , Yayımlama Sihirbazı dizeyi gerçek bilgisayar adına dönüştürmez. Bu durumda, çözümün geliştirme bilgisayarına yüklenmesi gerekir. Dağıtılan çözümlerin geliştirme bilgisayarında IIS kullanmasını sağlamak için localhost yerine tüm HTTP/HTTPS/FTP konumları için tam adı kullanın.

Önbelleğe alınmış derlemeler güncelleştirilmiş derlemeler yerine yüklenir

Derleme yükleyicisi .NET Framework Fusion, proje çıkış yolu bir ağ dosya paylaşımında olduğunda derlemelerin önbelleğe alınmış kopyasını yükler, derleme kesin bir adla imzalanır ve özelleştirmenin derleme sürümü değişmez. Bu koşullara uyan bir derlemeyi güncelleştirirseniz, önbelleğe alınan kopya yüklendiğinden projeyi bir sonraki çalıştırmanızda güncelleştirme görünmez.

Proje her çalıştırıldığında Fusion'ın derlemeleri indirmesi için Visual Studio'yu yapılandırabilirsiniz.

Önbelleğe alınmış kopyaları yüklemek yerine derlemeleri indirme

  1. Menü çubuğunda Proje,<ProjectName> Özellikleri'ni seçin.
  2. Uygulama sayfasında Derleme Bilgileri'ni seçin.
  3. Derleme Sürümünün üçüncü alanı olan düzeltme numarasını joker karakter (*) olarak ayarlayın. Örneğin, "1.0.*". Ardından Tamam düğmesini seçin.

Derleme sürümünü değiştirdikten sonra derlemenizi tanımlayıcı bir adla imzalamaya devam edebilirsiniz ve Fusion özelleştirmenin en son sürümünü yükler.

Not

Visual Studio 2017'den başlayarak Derleme Sürümünde joker karakterler kullanmayı denerseniz bir derleme hatası oluşur. Bunun nedeni, derleme sürümündeki joker karakterlerin MSBuild Deterministic özelliğini bozmasıdır. Joker karakterleri derleme sürümünden kaldırmanız veya determinizmi devre dışı bırakmanız istenir. Deterministic özelliği hakkında daha fazla bilgi edinmek için bkz. Yaygın MSBuild proje özellikleri ve Derlemenizi özelleştirme

URI'de US-ASCII olmayan karakterler olduğunda yükleme başarısız oluyor

Office çözümünü bir HTTP/HTTPS/FTP konumuna yayımladığınızda, yol US-ASCII'de olmayan unicode karakterlere sahip olamaz. Bu tür karakterler Kurulum programında tutarsız davranışlara neden olabilir. Yükleme yolu için US-ASCII karakterlerini kullanın.

Geliştirme bilgisayarına bir çözüm yayımlayıp yüklediğinizde el ile kaldırma istemi görüntülenir

Bir Office çözümü oluşturduğunuzda, yerleşik sürüm otomatik olarak kaydedilir. Daha önce geliştirme bilgisayarınıza aynı çözümü yayımladıysanız ve yüklediyseniz, Office için Visual Studio Araçları çalışma zamanı, çözüm bir sonraki derlendikten, yeniden oluşturulduktan veya yayımlandıktan sonra yayımlanan sürüm ve yerleşik sürüm için yükleme yolunun farklı olduğunu algılar. Hata iletisinde "Şu anda başka bir sürüm yüklü olduğundan ve bu konumdan yükseltilemediğinden özelleştirme yüklenemiyor" ifadesi yer alır. Bir çözüm yeniden oluşturulduğunda kayıt defteri anahtarları güncelleştirilir. Bu nedenle, yeni sürümü yayımlamadan, hata ayıklamadan veya çalıştırmadan önce önceki sürümü kaldırmanız gerekir.

İletinin görünmesini önlemek için dağıtımınızı test etmek üzere geliştirme bilgisayarınızda başka bir kullanıcı hesabı oluşturun. Alternatif olarak, çözümü bir sonraki yayımlamadan, hata ayıklamadan veya yeniden derlemeden önce sürümü bilgisayardaki yüklü programlar listesinden kaldırabilirsiniz.

Çözüm yüklediğinizde yakalanmayan özel durum veya yöntem bulunamadı hatası

Dağıtım bildirimini ( .vsto dosyası), Office uygulamasını, belgeyi veya çalışma kitabını açarak Office çözümlerini yüklediğinizde, aşağıdaki koşullara yönelik hata iletileri görünebilir:

  • Yöntem bulunamadı.
  • Missingmethodexception.
  • Yakalanmayan özel durum.

Bu hata iletilerini önlemek için Kurulum programını çalıştırarak çözümü yükleyin.

Kurulum programını çalıştırmadan çözümü yüklediğinizde, yükleyici önkoşulları denetlemez veya yüklemez. Kurulum programı önkoşulların doğru sürümünü denetler ve gerektiğinde yükler.

InstallShield Limited Edition projesi oluşturulduktan sonra Eklentiler için bildirim kayıt defteri anahtarları değişir

Bir VSTO Eklenti Kurulumu programının parçası olan bildirim kayıt defteri anahtarı, installShield Limited Edition projesi oluşturduğunuzda bazen .vsto'dan.dll.manifest'a dönüşür.

Bu sorunu geçici olarak çözmek için InstallShield Limited Edition projesini farklı bir çözümde oluşturun veya VSTO Eklentisinin adını içeren kayıt defteri anahtarının değeri olarak CompanyName.AddinName kullanın.

Office çözümünüz için ClickOnce Yükleyicisi birincil birlikte çalışma derlemelerini yüklemez

ClickOnce'un Office çözümünüz için oluşturduğu Kurulum programını çalıştırdığınızda, Office birincil birlikte çalışma derlemelerinin (PIA' lar) yükleyicisi yalnızca henüz yüklü PIA'lar yoksa çalışır.

Kurulum programı PIA'ları doğru yüklemezse, yükleme dizininden o2007pia.msi adlı yükleyici dosyasını çalıştırarak bunları el ile yükleyin.

Office çözümlerini yeniden yüklemek, bağımsız değişkenin aralık dışında özel duruma neden oluyor

Bir Office çözümünü yeniden yüklerken, şu hata iletisiyle bir ArgumentOutOfRangeException özel durum görüntülenebilir: Belirtilen bağımsız değişken geçerli değer aralığının dışındaydı.

Yükleme konumunun URL'si için büyük/küçük harf farklıysa bu durum oluşur. Örneğin, ilk seferden http://fabrikam.com/ExcelSolution.vsto bir Office çözümü yüklediyseniz ve ikinci kez kullandıysanız http://fabrikam.com/excelsolution.vsto bu hata görüntülenir.

İletinin görünmesini önlemek için, Office çözümlerini yüklerken aynı büyük/küçük harf kullanımını kullanın.

Web'den dağıtım bildirimi açılarak ClickOnce çözümü yüklenemiyor

Kullanıcılar, web'den dağıtım bildirimini açarak Office çözümlerini yükleyebilir. Ancak, Internet Information Services'in (IIS) bazı yüklemeleri .vsto dosya adı uzantısını engeller. Office çözümünü dağıtmak için kullanmadan önce IIS'de MIME türünü tanımlamanız gerekir.

IIS 7'de MIME türünü tanımlama hakkında bilgi için bkz. MIME Türü Ekleme (IIS7).

Uzantıyı .vsto ve MIME türünü application/x-ms-vsto olarak ayarlayın.

Başvurular