Microsoft Store paketi
Microsoft Store, GitHub’daki kurulum dosyasının yanında Keymotion’ı kurmanın ikinci yoludur. Microsoft yayımladığı her paketi imzalar, bu yüzden Windows Store’dan gelen kopyaya uyarı göstermeden güvenir. İki yolda da program aynıdır: Store paketi, tauri build komutunun yaptığı keymotion.exe’yi taşır. GitHub sürümünde hiçbir şey değişmez.
Store sürümü neyi farklı yapar
Bölüm başlığı “Store sürümü neyi farklı yapar”Uygulama hangi yoldan kurulduğunu çalışırken anlar. Windows, MSIX’ten kurulan bir programa paket kimliği verir; uygulama buna bakar (crates/kb-winsys/src/package.rs, app/src-tauri/src/channel.rs). Yalnızca çalışan keymotion.exe’yi içeren paket sayılır. Böylece başka bir paketli uygulamanın başlattığı geliştirme sürümü o uygulamanın paketini kendi paketi sanmaz.
| GitHub (kurulum dosyası, geliştirme sürümü) | Microsoft Store | |
|---|---|---|
| Güncellemeler | Uygulamanın kendi güncelleyicisi, GitHub sürümlerinden: Ayarlar › Hakkında › Güncellemeler’de kendiliğinden güncelle, haber ver ya da kapalı seçilir | Store. Güncelleyici kapalı kalır; Ayarlar › Hakkında, Store’un güncellemeler sayfasını açar. Uygulama kendini RegisterApplicationRestart ile kaydeder: Windows onu Store güncellemesini kurmak için kapatınca gizli olarak yeniden açılır. |
| Bildirim düğmeleri | Uygulamanın kendi keymotion: adreslerini açar (crates/kb-winsys/src/protocol.rs); adres şeması açılışta kullanıcı başına kaydedilir, kaldırıcı siler |
keymotion: adresi yok; tıklama uygulamayı paketin yoluyla başlatır |
| Windows açılınca başlatma | Kullanıcının Run anahtarında bir değer, --hidden ile |
Paketin başlangıç görevi (KeymotionStartup), yine --hidden ile. Kullanıcı bunu Windows ayarlarından kapatırsa yalnızca kendisi oradan yeniden açabilir; Ayarlar › Kapatma ve açılış o sayfaya bağlantı verir. |
| Bildirimlerdeki ad ve logo | Açılışta dev.keymotion uygulama kimliğiyle kaydedilir |
Paketin kendisinden gelir |
| Veri klasörleri | %APPDATA%\dev.keymotion, %LOCALAPPDATA%\dev.keymotion |
Uygulamanın gördüğü yollar aynıdır. Klasörler önceden yoksa Windows onları paketin kendi klasöründe tutar (%LOCALAPPDATA%\Packages\<paket ailesi>\LocalCache\…) ve uygulamayla birlikte siler; “Klasörü aç” o klasörü açar. |
| Ayarlar’daki gizlilik metni | GitHub’daki güncelleme denetiminden söz eder | Güncellemeleri Store’un getirdiğini söyler |
İki sürümün ortak bir kuralı var: nasıl kurulmuş olursa olsun aynı anda yalnızca bir Keymotion çalışır. İkisi birden çalışsa klavyeye aynı anda komut gönderirlerdi.
Daha önce GitHub’daki Keymotion kurulduysa klasörleri zaten vardır; Store sürümü onları olduğu gibi okur ve yazar. Ayarlar aynen devam eder ve iki sürüm aynı klasörleri kullanır. Windows yalnızca bir paketin sıfırdan oluşturduğu klasörleri paketin kendi yerine taşır.
İkisi birden kuruluysa
Bölüm başlığı “İkisi birden kuruluysa”Kendi hâline bırakılsa iki kopya da bilgisayar açılınca başlamaya çalışır ve önce davranan çalışırdı: bir gün güncelleyicisinin yükselttiği GitHub kopyası, ertesi gün Store’unki. Bu yüzden Store kopyası kurulunca GitHub kopyası ona yol verir (app/src-tauri/src/handoff.rs). Microsoft da kullanıcıları Store paketine geçirirken bunu önerir:
- Kurulu GitHub kopyası başlarken (kurulum dosyasının kaydettiği klasördeki program; geliştirme ya da depodan derlenmiş sürüm asla) Store paketini arar (
GetPackagesByPackageFamily). Paket varsa Store kopyasınıIApplicationActivationManagerile başlatır ve kapanır. - GitHub kopyası bilgisayar açılınca başlayacak biçimde ayarlıysa
Rundeğerini siler ve--take-startupverir: Store kopyası kendi başlangıç görevini açar; kullanıcı ya da bir ilke kapattıysa açmaz. - Bilgisayar açılınca başlayan ikinci kopya, açık bir kopya bulursa sessizce kapanır;
--hiddenile gelen ikinci açılış pencereyi öne getirmez. - GitHub kopyası kurulu kaldıkça Store kopyasının Ayarlar › Hakkında bölümünde “GitHub kopyası” satırı görünür. Satırdaki düğme Windows’un Yüklü uygulamalar sayfasını açar; kullanıcı GitHub kopyasını oradan kaldırabilir. İki kopya ayarları paylaştığı için ayarlar kalır; yeter ki kaldırıcıda Ayarlarımı ve kayıtlarımı da sil kutusu işaretlenmesin.
Bu değişiklikten eski GitHub kopyaları (1.0.0) yol vermez; bir sonraki güncellemeleriyle bu davranış gelir.
| Dosya | Ne işe yarar |
|---|---|
app/src-tauri/store/AppxManifest.xml |
Paket bildirimi; kimlik ve sürüm için boş yerler içerir. Tam güven (runFullTrust): program, kurulum dosyasından kurulduğundaki gibi kullanıcının olağan yetkileriyle çalışır. HID, göstergeler ve saatin yanındaki simge bunu gerektirir. |
app/src-tauri/store/Assets/ |
Windows’un istediği her boyutta logolar. tools/store/make-assets.py, app/src-tauri/icons/icon.png dosyasından çizer. Simge değişince yeniden çalıştırın. |
tools/store/msix.mjs |
Bildirimi doldurur, logoları dizinler (makepri) ve MSIX’i paketler (makeappx). Windows SDK gerekir. Testler: node --test "tools/store/*.test.mjs". |
.github/workflows/store.yml |
Yayımlanmış bir sürümün paketini oluşturur. |
Paket imzalanmaz: Store, sertifikasyondan geçen paketi kendisi imzalar. CI her değişiklikte bir deneme paketi oluşturur. Böylece Windows araçlarının reddedeceği bir bildirim ya da logo sürümden önce fark edilir.
Sürüm numaraları
Bölüm başlığı “Sürüm numaraları”İki kanal için tek bir sürüm numarası ve tek bir değişiklik listesi vardır. Store paketinin sürüm numarası dört parçalıdır: dördüncü parça Store’a aittir ve her zaman 0’dır; ilk parça 0’dan büyük olmalıdır. Keymotion 1.2.3, 1.2.3.0 paketi olur. Kullanıcının gördüğü tek fark budur (Windows’un yüklü uygulamalar listesinde).
msix.mjssürümütauri.conf.jsondosyasından alır.--versionyalnızca deneme paketlerinde çalışır; bu yüzden bir Store paketi, aynı kodun GitHub sürümünden başka bir numara taşıyamaz.store.ymlyalnızcamainüzerindeki bir sürüm etiketini paketler; bu yüzden Store, GitHub’da olmayan bir sürüm alamaz.- Store deneme sürümlerini (
1.3.0-rc.1) almaz; onlar GitHub’da kalır. - İki kanal bir sürümü aynı gün yayımlar: GitHub sürümü, Store kopyası sertifikasyondan geçene kadar taslak olarak bekler (aşağıda: Sürüm yayımlama). Sürüm notları ikisini birden anlatır; yalnızca bir kanalı ilgilendiren değişiklik bunu belirtir.
- Store’a bir kez yüklenmiş numara bir daha kullanılmaz: Store bir paketi geri çevirirse düzeltme, iki kanalda birden bir sonraki yama sürümüyle gelir.
- Tanılama bilgisi ve destek istekleri kopyanın nereden geldiğini gösterir:
App version: 1.0.0 (Microsoft Store),(GitHub)ya da(development build).
Paketi kendi bilgisayarınızda deneyin
Bölüm başlığı “Paketi kendi bilgisayarınızda deneyin”Windows’un geliştirici modu açıksa (Ayarlar › Sistem › Geliştiriciler için), uydurma kimlikli bir paket (“Keymotion (test)”) sertifika olmadan kurulur. Store’un paketine hiç karışmaz.
-
Programı derleyin ve paketleyin:
Terminal window pnpm --dir app tauri build --no-bundlenode tools/store/msix.mjs --exe target/release/keymotion.exe --out target/store-test --test -
Keymotion açıksa kapatın (saatin yanındaki simge › Çık). Sonra paketi PowerShell’de kendi klasöründen kurun:
Terminal window Add-AppxPackage -Register target\store-test\layout\AppxManifest.xml -
Başlat menüsünden Keymotion (test) uygulamasını açın.
-
İşiniz bitince kaldırın. Bu, paketin oluşturduğu dosyaları da siler:
Terminal window Get-AppxPackage Keymotion.StoreTest | Remove-AppxPackage
Sürüm yayımlama
Bölüm başlığı “Sürüm yayımlama”Bir sürüm GitHub’da ve Microsoft Store’da aynı gün çıkar; böylece bir numara ya her yerde vardır ya hiçbir yerde (proje sahibinin kararı, 2026-11-16).
-
Sürümü her zamanki gibi
mainüzerinde etiketleyin.release.ymlkurulum dosyasını derler ve GitHub sürümünü taslak olarak hazırlar; Microsoft Store package işi (store.yml) aynı etiketten.msixdosyasını derler ve çalıştırmanın çıktısı olarak saklar. Deneme sürümlerinde bu iş atlanır. -
GitHub taslağını yayımlamayın. Partner Center’da Keymotion için yeni bir gönderim başlatın: Paketler bölümüne
.msixdosyasını yükleyin ve öncekini kaldırın; “Yenilikler” alanını değişiklik listesinden doldurun; Gönderim seçenekleri’nde “Don’t publish this submission until I select Publish now” seçeneğini seçin. Gönderin. -
Sertifikasyondan geçince (Microsoft en çok üç iş günü öngörür) GitHub taslağını yayımlayın ve Partner Center’da Publish now düğmesine basın; ikisini birlikte.
- Store paketi geri çevirirse: Düzeltmeyi bir sonraki yama sürümünde yapın ve onu iki kanalda yayımlayın. Geri çevrilen numara hiçbir yerde yayımlanmaz; değişiklik listesindeki bölümü yeni numaraya taşınır. Yalnızca mağaza sayfasıyla (metin, ekran görüntüleri) ilgili bir ret yeni paket gerektirmez.
- Acil düzeltme (çökme, güvenlik sorunu) önce GitHub’da yayımlanabilir; sürüm notları Store’un arkadan geleceğini söyler.
- Store işi elle de çalıştırılabilir: GitHub › Actions › Microsoft Store package, sürüm etiketiyle (
v1.2.3).
İş akışı, Partner Center › Keymotion › Ürün kimliği sayfasından aynen kopyalanan üç depo değişkeni ister: STORE_IDENTITY_NAME, STORE_PUBLISHER ve STORE_PUBLISHER_DISPLAY_NAME. Bunlar gizli değildir; her pakette görünürler.
Uygulama yayına girdikten sonra gönderim iş akışından da yapılabilir (Microsoft’un msstore aracıyla). Ancak bunun için Partner Center hesabına erişimi olan bir Microsoft Entra uygulama kaydı gerekir. Bireysel geliştirici hesabı bunun için bir Microsoft Entra kiracısı oluşturabilir ya da bağlayabilir (Partner Center › Account settings › Tenants). Bunun kurulması hâlâ açık bir konu; şimdilik yükleme elle yapılır.