Komut Satırından ClickOnce Uygulamalarını Yapılandırma
Visual Studio içinde, projeler tümleşik geliştirme ortamında (IDE) oluşturulsa dahi komut satırından bunları yapılandırabilirsiniz. Aslında, sadece .NET Framework'e sahip olan başka bir bilgisayar üzerinde Visual Studio ile oluşturulmuş bir projeyi yeniden yapılandırabilirsiniz. Bu, otomatikleştirilmiş bir işlem kullanarak yeniden yapı oluşturmanızı sağlar. Örneğin, merkezi bir yapı laboratuarında veya projenin kendi yapılandırma kapsamının ötesinde gelişmiş komut soyası teknikleri kullanarak bunu yapabilirsiniz.
ClickOnce Uygulama Dağıtımlarını Yeniden Oluşturmak için MSBuild Kullanma
Komut satırında msbuild /target:publish'ı çağırdığınızda, bu MSBuild sistemine projeyi yapılandırmasını ve yayımla dosyasında bir ClickOnce uygulaması oluşturmasını söyler. Bu, IDE'de Yayımla komutunu seçmekle eşdeğerdir.
Bu komut, Visual Studio komut istemi ortamı yolunda olan msbuild.exe'yi çalıştırır.
Bir "target", komutun nasıl işleneceği üzerine MSBuild için bir göstergedir. Anahtar hedefler, "build" hedefi ve "publish" hedefidir. Yapı hedefi, IDE'de Yapı komutunu seçmekle (ya da F5'e basmak) eşdeğerdir. Projenizi sadece oluşturmak istiyorsanız, msbuild yazarak bunu başarabilirsiniz. Yapı hedefi Visual Studio tarafından oluşturulan tüm projeler için varsayılan hedef olduğu için bu komut çalışır. Bu, yapı hedefini açıkça belirtmenize gerek yok anlamına gelir. Bu nedenle, msbuild yazmak msbuild /target:build yazmakla aynı işlemdir.
/target:publish komutu yayımla hedefinin çağrılmasını MSBuild'e bildirir. Yayımla hedefi yapı hedefine bağlıdır. Bu, yayımla işleminin yapı işleminin bir üst kümesidir anlamına gelir. Örneğin, Visual Basic veya C# kaynak dosyalarınızdan birisini değiştirdiyseniz, karşılık gelen derleme yayımla işlemi tarafından otomatik olarak yeniden yapılandırılacaktır.
ClickOnce bildiriminizi oluşturmak için Mage.exe komut satırını kullanarak tam bir ClickOnce dağıtımı oluşturma üzerine daha fazla bilgi için, bkz. İzlenecek yol: El ile ClickOnce uygulama dağıtma.
MSBuild Kullanarak Temel ClickOnce Uygulaması Oluşturma ve Yapılandırma
Bir ClickOnce projesi oluşturmak ve yayımlamak için
Dosya menüsünden Yeni Proje'yi tıklayın. Yeni Proje iletişim kutusu görüntülenir.
Windows Uygulaması'nı seçin ve bunu CmdLineDemo olarak adlandırın.
Yapı menüsünden, Yayımla komutunu tıklayın.
Bu adım, ClickOnce uygulama dağıtımını üretmek için düzgün yapılandırılmış bir proje sağlar.
Yayımla Sihirbazı görüntülenir.
Yayımla Sihirbazında Son'u tıklayın.
Visual Studio, Publish.htm adıyla varsayılan Web sayfasını oluşturur ve görüntüler.
Projenizi kaydedin ve depolandığı klasör konumunu not edin.
Yukarıdaki adımlar ilk kez yayımlanmış bir ClickOnce projesi oluşturur. Şimdi yapıyı IDE dışında yeniden oluşturabilirsiniz.
Yapıyı komut satırından yeniden oluşturmak için
Visual Studio'dan çıkın.
Windows Başlat menüsünden, Tüm Programlar'ı, sonra Microsoft Visual Studio'yu, sonra Visual Studio Araçları'nı ve Visual Studio Komut İstemi'ni tıklayın. Bu, mevcut kullanıcının kök klasöründe bir komut istemi açmalıdır.
Visual Studio Komut İstemi içinde, mevcut dizini henüz yukarıda yapılandırdığınız projenin konumuna getirin. Örneğin, chdir My Documents\Visual Studio\Projects\CmdLineDemo yazın.
"Bir ClickOnce projesi oluştrmak ve yayımlamak için" içinde oluşturulmuş dosyaları kaldırmak için, rmdir /s publish yazın.
Bu adım isteğe bağlıdır, ancak yeni dosyaların tümünün komut satırı yapılandırması tarafından üretilmiş olduğunu temin eder.
msbuild /target:publish yazın.
Yukarıdaki adımlar projenizin Yayımla olarak adındaki klasörde tam bir ClickOnce uygulaması dağıtımı oluşturacaktır. CmdLineDemo.application, ClickOnce dağıtım bildirimidir. CmdLineDemo_1.0.0.0 klasörü CmdLineDemo.exe, CmdLineDemo.exe.manifest ve ClickOnce uygulaması bildirimi dosyalarını içerir. Setup.exe .NET Framework'ü yüklemek için vasayılan olarak yapılandırılan bir önyükleyicidir. The DotNetFX klasörü, .NET Framework için yeniden dağıtılabilirleri (redistributables) içerir. Bu; Web, UNC veya CD/DVD yoluyla uygulamanızı dağıtmanız için gereken tüm dosyalar kümesidir.
Yayımlama Özellikleri
Yukarıdaki yordamlarda uygulamayı yayımladığınızda, aşağıdaki özellikler Yayımla Sihirbazı tarafından proje dosyanızın içine eklenir. Bu özellikler doğrudan ClickOnce uygulamasının nasıl üretileceğini etkiler.
CmdLineDemo.vbproj / CmdLineDemo.csproj içinde:
<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>http://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateInterval>7</UpdateInterval>
<UpdateIntervalUnits>Days</UpdateIntervalUnits>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>
Proje dosyasının kendisini değiştirmeden komut satırında bu özelliklerden istediğinizi geçersiz kılabilirsiniz. Öğneğin, aşağıdaki bölüm önyükleyici olmadan ClickOnce uygulamasını yapılandıracak.
msbuild /target:publish /property:BootstrapperEnabled=false
Yayımlama özellikleri, Proje Tasarımcısı'nın Yayımla , Güvenlik ve Signing (İmza) özellik sayfalarından Visual Studio içinde kontrol edilir. Aşağıdaki bölüm, uygulama tasarımcısının çeşitli özellik sayfalarında her birinin nasıl ayarlanacağı ve yayımlama özellikleri üzerine bir açıklamadır:
- AssemblyOriginatorKeyFile, ClickOnce uygulama bildirimlerini imzalamak için kullanılan anahtar dosyayı belirler. Bu aynı anahtar derlemelerinize bir tanımlayıcı ad atamak için de kullanılabilir. Bu özellik, Proje Tasarımcısı'nın İmza sayfasında ayarlanır.
Aşağıdaki özellikler Güvenlik sayfasında ayarlanır:
Enable ClickOnce Security Settings (ClickOnce Güvenlik Ayarlarını Etkinleştirin), ClickOnce bildirimlerinin oluşturulup oluşturulmaması durumunu belirler. Bir proje ilk olarak oluşturulduğunda, ClickOnce bildirim oluşturma varsayılan olarak kapalıdır. İlk olarak yayımladığınızda, sihirbaz otomatik olarak bu bayrağı açar.
TargetZone, ClickOnce uygulama bildiriminiz için geçerli olacak güven düzeyini belirler. Olası değerler şunlardır: "Internet", "LocalIntranet" (YerelIntranet) ve "Özel". Internet ve LocalIntranet , varsayılan izin kümesinin ClickOnce uygulama bildiriminiz için geçerli olmasına neden olur. LocalIntranet varsayılan değerdir ve temel olarak tam güven anlamına gelir. Özel, sadece temel app.manifest dosyasında açıkça belirtilen izinlerin ClickOnce uygulama bildirimi için geçerli olacağını belirtir. app.manifest dosyası yalnızca güven bilgisi tanımlarını içeren kısmi bir bildirim dosyasıdır. Projenize Güvenlik sayfası üzerinde izinleri yapılandırdığınızda otomatik olarak eklenen gizli bir dosyadır.
Aşağıdaki özellikler Yayımla sayfasında ayarlanır:
PublishUrl, IDE'de uygulamanın yayımlanacağı konumdur. InstallUrl ve UpdateUrl özelliklerinin ikisi de belirtilmemişse, ClickOnce içine eklenir.
ApplicationVersion, ClickOnce uygulamasının sürümünü belirtir. Bu, dört basamaklı sürüm numarasıdır. Son rakam "*" ise, ApplicationRevision yapı zamanında bildirim içine eklenen değerin yerine konulur.
ApplicationRevision, düzeltmeyi belirtir. Bu, IDE içinde her yayımladığınızda artan bir tamsayıdır. Komut satırında gerçekleştirilen yapılar için otomotik artırmanın geçerli olmadığına dikkat edin.
Install, uygulamanın yüklenmiş bir uygulama mı Web uygulaması mı olduğunu belirler.
InstallUrl (gösterilmez), kullanıcıların uygulamayı yükleyecekleri konumdur. Belirtilmişse, bu değer IsWebBootstrapper özelliği etkinse setup.exe önyükleyicisi içine yazılır. UpdateUrl belirtilmemişse, uygulama bildirimi içine de eklenir.
SupportUrl (gösterilmez), yüklü bir uygulama için Program Ekle veya Kaldır iletişim kutusunda bağlantılandırılan konumdur.
Aşağıdaki özellikler, Yayımla sayfasından erişilen Application Updates'te (Uygulama Güncelleştirmeleri) ayarlanır.
UpdateEnabled, uygulamanın güncelleştirmeleri denetleyip denetlemeyeceğini gösterir.
UpdateMode, ön plan güncelleştirmelerini ya da arka plan güncelleştirmelerini belirtir.
UpdateInterval, uygulamanın hangi sıklıkta güncelleştirmeleri denetleyeceğini belirtir.
UpdateIntervalUnits, UpdateInterval değerinin hangi birimde olduğunu (saat, gün veya hafta) belirtir.
UpdateUrl (gösterilmez), uygulamanın güncelleştirmeleri alacağı konumdur. Belirtilmişse, bu değer uygulama bildirimine eklenir.
Aşağıdaki özellikler, Yayımla sayfasından erişilen Yayımla Seçenekleri iletişim kutusunda ayarlanır.
PublisherName, uygulamayı yüklediğinizde veya çalıştırdığınızda gösterilen istemde verilen yayımcı ismini belirtir. Yüklü bir uygulama olması durumunda, Başlat menüsündeki klasör ismini belirtmek için de kullanılır.
ProductName, uygulamayı yüklediğinizde veya çalıştırdığınızda gösterilen istemde verilen ürün ismini belirtir. Yüklü bir uygulama olması durumunda, Başlat menüsündeki kısayol ismini belirtmek için de kullanılır.
Aşağıdaki özellikler, Yayımla sayfasından erişilen Önkoşullar iletişim kutusunda ayarlanır.
BootstrapperEnabled, setup.exe önyükleyicisinin oluşturulup oluşturulmamasını belirler.
IsWebBootstrapper, setup.exe önyükleyicisinin Web üzerinden mi disk tabanlı modda mı çalışacağını belirler.
InstallURL, SupportUrl, PublishURL ve UpdateURL
Aşağıdaki tablo ClickOnce dağıtımı için dört URL seçeneği gösterir.
URL seçeneği |
Description |
|---|---|
PublishURL |
ClickOnce uygulamanızı bir Web sitesine yayımlarsanız gerekli. |
InstallURL |
İsteğe Bağlı. Bu URL seçeneğini yükleme sitesi, PublishURL'den farklı ise ayarlayın. Örneğin, PublishURL'yi bir FTP yolu olarak, InstallURL'yi Web URL'si olarak ayarlayabilirsiniz. |
SupportURL |
İsteğe Bağlı. Bu URL seçeneğini destek sitesi, PublishURL'den farklı ise ayarlayın. Örneğin, SupportURL'yi şirketinizin Müşteri Destek Web sitesi olarak ayarlayabilirsiniz. |
UpdateURL |
İsteğe Bağlı. Bu URL seçeneğini güncelleştirme konumu InstallURL'den farklı ise ayarlayın. Örneğin, PublishURL'yi bir FTP yolu olarak, UpdateURL'yi Web URL'si olarak ayarlayabilirsiniz. |
Ayrıca bkz.
Görevler
İzlenecek yol: El ile ClickOnce uygulama dağıtma