Flutter’da Windows build için “msix” kullanımı

Flutter projelerinizi Windows mağazasında paylaşmak mı istiyorsunuz? msix paketi ile Flutter uygulamanızı Universal Windows Platform (UWP) uygulaması olarak paketlemek oldukça kolay! Bu yazıda, msix 3.16.8 versiyonunu kullanarak Flutter projenizi Windows UWP formatında nasıl paketleyeceğinizi adım adım göstereceğim.

1. msix Nedir?

msix, Windows uygulamalarını paketlemek için kullanılan yeni nesil bir formattır. Bu format, uygulamanızın kolayca kurulmasını ve güncellenmesini sağlar. msix formatı ile paketlenen uygulamalar, Windows Mağazası'na yüklenebilir veya doğrudan bir kurulum dosyası olarak dağıtılabilir.

2. Gerekli Kurulumlar

İlk olarak, Flutter projelerinizi msix formatında paketleyebilmek için aşağıdaki gereksinimleri karşılamanız gerekiyor:

• Flutter SDK: Flutter’ı zaten kurduğunuzu varsayıyorum.
• Visual Studio 2019 veya 2022: Flutter uygulamalarını UWP formatında çalıştırabilmek için Visual Studio’nun “Desktop Development with C++” ve “UWP Development” bileşenlerinin yüklü olduğundan emin olun.
• Windows 10/11 SDK: MSIX paketleri oluşturabilmek için sisteminizde yüklü olmalıdır.

Eğer henüz Flutter’ı Windows ortamında çalıştırmadıysanız, bu yazıdan önce Flutter Windows ortamında nasıl çalıştırılır? başlıklı dokümana göz atmanızı tavsiye ederim.

3. Proje Ayarları

3.1. Flutter Projesi Oluşturma

İlk olarak, bir Flutter projesi oluşturun ya da var olan bir projeyi kullanabilirsiniz. Terminalde şu komutu çalıştırarak yeni bir proje oluşturabilirsiniz:

flutter create my_uwp_project
cd my_uwp_project

3.2. msix Paketini Projeye Ekleyin

Flutter projenizi msix formatında paketleyebilmek için msix paketini projenize dahil etmemiz gerekiyor. pubspec.yaml dosyanıza şu satırları ekleyin:

msix: ^3.16.8

Ardından terminalde şu komutu çalıştırarak paketleri yükleyin:

flutter pub get

3.3. Windows için Gerekli Ayarların Yapılması

Projenizin windows klasörüne gidip runner dizini altındaki Main.cpp dosyasını açın. Uygulamanızın MSIX ile uyumlu çalışabilmesi için bu dosyadaki pencere yapılandırmalarını kontrol edin.

Ek olarak, windows/runner/WinRunner.rc dosyasındaki uygulama simgesi ve detaylarını dilediğiniz gibi güncelleyebilirsiniz.

4. msix_config.yaml Dosyasını Yapılandırma

msix paketini kullanabilmek için projenizin kök dizinine msix_config.yaml adında bir yapılandırma dosyası eklememiz gerekiyor. Bu dosya, uygulamanızın paketleme ayarlarını belirler. Örnek bir msix_config.yaml dosyası aşağıdaki gibidir:

display_name: My UWP App
publisher_display_name: My Company
identity_name: 12345678-1234-1234-1234-123456789abc
publisher: CN=mycompany
version: 1.0.0.0
logo_path: assets/icons/app_icon.ico
capabilities:
  - internetClient
  - location
  - microphone
  - camera
  - documentsLibrary
sign_tool: 
  path: C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\signtool.exe
  cert_file: C:\path\to\certificate.pfx
  password: my_certificate_password

Önemli Alanlar:

• display_name: Uygulamanızın adını temsil eder.
• publisher_display_name: Yayıncı adınız (genellikle şirket adınız).
• identity_name: Uygulamanızın benzersiz kimliği. Bu değeri Microsoft mağaza hesabınızda oluşturabilirsiniz.
• publisher: Yayıncı bilgisi, sertifikadan alınmalıdır.
• logo_path: Uygulamanızın simgesi için bir yol belirtmelisiniz.
• capabilities: Uygulamanızın hangi yetkilere sahip olacağını belirler (örn. internet kullanımı).
• sign_tool: Eğer uygulamanızı imzalamak isterseniz, sign_tool ile gerekli sertifika ve araç yolunu belirtmeniz gerekmektedir.

5. Uygulamanın MSIX Formatında Paketlenmesi

Gerekli yapılandırmaları yaptıktan sonra, artık uygulamanızı paketleyebiliriz. Terminalde şu komutu çalıştırın:

flutter pub run msix:create

Bu komut çalıştırıldığında, proje klasörünüzde msix formatında bir dosya oluşturulacak. Bu dosyayı doğrudan paylaşabilir veya Microsoft Mağazası'na yükleyebilirsiniz.

İmza Ekleme (Opsiyonel)

Eğer uygulamanızın sertifikayla imzalanması gerekiyorsa, msix_config.yaml dosyasında imza aracını ve sertifikayı tanımladıktan sonra, flutter pub run msix:create komutu çalıştırıldığında otomatik olarak imzalanacaktır. İmzasız uygulamalar yalnızca lokal sistemde çalıştırılabilir, ancak imzalı uygulamalar herhangi bir Windows bilgisayarında kurulabilir.

6. Uygulamanızı Test Etme

Oluşturduğunuz msix dosyasını test etmek için, çift tıklayarak bilgisayarınıza kurabilirsiniz. Windows 10/11'de herhangi bir UWP uygulaması gibi çalışacaktır.

7. Sonuç

Tebrikler! Flutter projenizi başarıyla msix formatında paketlediniz. Bu paketleme yöntemi, uygulamalarınızın dağıtımını ve kurulumunu kolaylaştırır. Ayrıca, Microsoft Mağazası'na uygulamanızı yüklemek için gereklidir.