Windows'da .NET MAUI uygulamanızı dağıtma ve hatalarını ayıklama

Yeni bir .NET MAUI projesinde hata ayıklama ve Windows'a dağıtma sırasında varsayılan davranış paketlenmiş bir uygulama dağıtmaktır. Paketlenmiş uygulamalar hakkında bilgi için bkz . Windows uygulamaları: paketleme, dağıtım ve işlem.

Windows'ı paketlenmiş uygulama dağıtımı için yapılandırma

Paketlenmiş bir .NET MAUI Windows uygulaması dağıtabilmek için Windows'ta Geliştirici Modu'nu etkinleştirmeniz gerekir. Hem Windows 10 hem de Windows 11 desteklenir.

Windows 11

Geliştirici Modu, Ayarlar uygulamasında, Geliştiriciler için Gizlilik ve güvenlik>bölümünde etkinleştirilir. Windows 11'de Geliştirici Modu'nu etkinleştirmek için:

1. Başlat Menüsünü açın.
2. Arama kutusuna Geliştirici ayarları yazın ve seçin.
3. Geliştirici Modu'nu açın.
4. Geliştirici Modu hakkında bir uyarı iletisi alırsanız bu uyarıyı okuyun ve uyarıyı anlıyorsanız Evet'i seçin.

Windows 10

Geliştirici Modu, Ayarlar uygulamasında, Güncelleştirme ve Geliştiriciler için Güvenlik>altında etkinleştirilir. Windows 10'da Geliştirici Modu'nu etkinleştirmek için:

1. Başlat Menüsünü açın.
2. Geliştirici ayarları için arama yapın ve seçin.
3. Geliştirici Modu'nu açın.
4. Geliştirici Modu hakkında bir uyarı iletisi alırsanız bu uyarıyı okuyun ve uyarıyı anlıyorsanız Evet'i seçin.

Hedef Windows

Paketlenmiş bir .NET MAUI Windows uygulamasını paketten çıkarılmaya dönüştürme

Mevcut bir .NET MAUI Windows paketlenmiş uygulamasını Visual Studio'da paketlenmemiş bir uygulamaya dönüştürmek için:

1. Çözüm Gezgini'da .NET MAUI uygulama projenize sağ tıklayın ve Özellikler'i seçin. Ardından Uygulama Windows Hedefleri sekmesine gidin ve Windows MSIX paketi oluştur seçeneğinin işaretinin kaldırıldığından emin > olun:

   

Visual Studio, derleme özelliğini Noneolarak ayarlamak için uygulamanızın $(WindowsPackageType) proje dosyasını (*.csproj) değiştirir:

<PropertyGroup>
    <WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>

Buna ek olarak, uygulamanızın Özellikler/launchSettings.json dosyasında değeri olarak commandName değiştirilir MsixPackage Project:

{
  "profiles": {
    "Windows Machine": {
      "commandName": "Project",
      "nativeDebugging": false
    }
  }
}

Paketlenmemiş bir .NET MAUI Windows uygulamasını paketlenmişe dönüştürme

Uygulamanızın yalnızca Windows paketli uygulamalarla kullanılabilen API'leri kullanması gerekiyorsa ve uygulamanızı Microsoft Store üzerinden dağıtmayı planlıyorsanız, paketlenmemiş uygulamanızı paketlenmiş bir uygulamaya dönüştürmeniz gerekir. Bu, Visual Studio'da yapılabilir:

1. Çözüm Gezgini'da .NET MAUI uygulama projenize sağ tıklayın ve Özellikler'i seçin. Ardından Uygulama Windows Hedefleri sekmesine gidin ve Windows MSIX paketi oluştur seçeneğinin işaretli olduğundan emin olun:>

   

Visual Studio, satırı kaldırmak <WindowsPackageType>None</WindowsPackageType> için uygulamanızın proje dosyasını (.csproj) değiştirir. Buna ek olarak, uygulamanızın Özellikler/launchSettings.json dosyasında değeri olarak commandName değiştirilir Project MsixPackage:

{
  "profiles": {
    "Windows Machine": {
      "commandName": "MsixPackage",
      "nativeDebugging": false
    }
  }
}

Paketlenmiş bir .NET MAUI Windows uygulaması dağıtırken Windows'da Geliştirici Modu'nu etkinleştirmeniz gerekir. Daha fazla bilgi için bkz . Windows'ı paketlenmiş uygulama dağıtımı için yapılandırma.

Yeni bir .NET MAUI projesinde hata ayıklama ve Windows'a dağıtma sırasında varsayılan davranış paketlenmemiş bir uygulama dağıtmaktır. Paketlenmemiş uygulamalar hakkında bilgi için bkz . Windows uygulamaları: paketleme, dağıtım ve işlem.

Hedef Windows

Paketlenmemiş bir .NET MAUI Windows uygulamasını paketlenmişe dönüştürme

Uygulamanızın yalnızca Windows paketli uygulamalarla kullanılabilen API'leri kullanması gerekiyorsa ve uygulamanızı Microsoft Store üzerinden dağıtmayı planlıyorsanız, paketlenmemiş uygulamanızı paketlenmiş bir uygulamaya dönüştürmeniz gerekir. Bu, Visual Studio'da yapılabilir:

1. Çözüm Gezgini'da .NET MAUI uygulama projenize sağ tıklayın ve Özellikler'i seçin. Ardından Uygulama Windows Hedefleri sekmesine gidin ve Windows MSIX paketi oluştur seçeneğinin işaretli olduğundan emin olun:>

   

Visual Studio, satırı kaldırmak <WindowsPackageType>None</WindowsPackageType> için uygulamanızın proje dosyasını (.csproj) değiştirir. Buna ek olarak, uygulamanızın Özellikler/launchSettings.json dosyasında değeri olarak commandName değiştirilir Project MsixPackage:

{
  "profiles": {
    "Windows Machine": {
      "commandName": "MsixPackage",
      "nativeDebugging": false
    }
  }
}

Paketlenmiş bir .NET MAUI Windows uygulaması dağıtırken Windows'da Geliştirici Modu'nu etkinleştirmeniz gerekir. Daha fazla bilgi için bkz . Windows'ı paketlenmiş uygulama dağıtımı için yapılandırma.

Paketlenmiş bir .NET MAUI Windows uygulamasını paketten çıkarılmaya dönüştürme

Mevcut bir .NET MAUI Windows paketlenmiş uygulamasını Visual Studio'da paketlenmemiş bir uygulamaya dönüştürmek için:

1. Çözüm Gezgini'da .NET MAUI uygulama projenize sağ tıklayın ve Özellikler'i seçin. Ardından Uygulama Windows Hedefleri sekmesine gidin ve Windows MSIX paketi oluştur seçeneğinin işaretinin kaldırıldığından emin > olun:

   

Visual Studio, derleme özelliğini Noneolarak ayarlamak için uygulamanızın $(WindowsPackageType) proje dosyasını (*.csproj) değiştirir:

<PropertyGroup>
    <WindowsPackageType>None</WindowsPackageType>
</PropertyGroup>

Buna ek olarak, uygulamanızın Özellikler/launchSettings.json dosyasında değeri olarak commandName değiştirilir MsixPackage Project:

{
  "profiles": {
    "Windows Machine": {
      "commandName": "Project",
      "nativeDebugging": false
    }
  }
}

Windows'ı paketlenmiş uygulama dağıtımı için yapılandırma

Paketlenmiş bir .NET MAUI Windows uygulaması dağıtabilmek için Windows'ta Geliştirici Modu'nu etkinleştirmeniz gerekir. Hem Windows 10 hem de Windows 11 desteklenir.

Windows 11

Geliştirici Modu, Ayarlar uygulamasında, Geliştiriciler için Gizlilik ve güvenlik>bölümünde etkinleştirilir. Windows 11'de Geliştirici Modu'nu etkinleştirmek için:

1. Başlat Menüsünü açın.
2. Arama kutusuna Geliştirici ayarları yazın ve seçin.
3. Geliştirici Modu'nu açın.
4. Geliştirici Modu hakkında bir uyarı iletisi alırsanız bu uyarıyı okuyun ve uyarıyı anlıyorsanız Evet'i seçin.

Windows 10

Geliştirici Modu, Ayarlar uygulamasında, Güncelleştirme ve Geliştiriciler için Güvenlik>altında etkinleştirilir. Windows 10'da Geliştirici Modu'nu etkinleştirmek için:

1. Başlat Menüsünü açın.
2. Geliştirici ayarları için arama yapın ve seçin.
3. Geliştirici Modu'nu açın.
4. Geliştirici Modu hakkında bir uyarı iletisi alırsanız bu uyarıyı okuyun ve uyarıyı anlıyorsanız Evet'i seçin.