Branch Manager, Kuika platformunda geliştirdiğiniz uygulamada yaptığınız değişiklikleri güvenle yönetmenizi, farklı Branch'ler üzerinde bağımsız çalışmanızı ve değişikliklerinizi istediğinizde ana projenizle birleştirmenizi sağlar.

Branch Manager ile yapabilecekleriniz:

• Branch'ler oluşturabilir, bunlar arasında geçiş yapabilirsiniz.
• Değişikliklerinizi commit ederek Checkpoint'ler oluşturabilirsiniz.
• Değişiklikleri Before/After görünümleriyle inceleyebilir, geri alabilirsiniz.
• Branch'leri birleştirip (merge) geliştirmelerinizi ana projeye aktarabilirsiniz.
• Merge sırasında oluşan Conflict'leri çözebilirsiniz.

1. Branch Manager Ekranına Erişme

Branch Manager özelliğine erişmek için Kuika editöründe üst navigasyon çubuğundaki dal (branch) ikonuna tıklayın. Özellik henüz aktive edilmemişse aşağıdaki ekranla karşılaşırsınız.

2. Branch Manager'ı Aktive Etme

Branch Manager varsayılan olarak pasiftir; proje bazında manuel olarak aktive edilmesi gerekir. Aktivasyon ekranındaki Activate Version Control butonuna tıklayın. Aktivasyon tamamlandığında sistem otomatik olarak bir master branch oluşturur ve sol panelde Branch List görünür hale gelir.

3. Yeni Branch Oluşturma

‍

Branch List başlığının yanındaki + simgesine tıklayın. Açılan New Branch diyaloğunda aşağıdaki alanları doldurun:

• Branch Name: Yeni branch için tanımlayıcı bir ad girin (örneğin feature-login veya bugfix-header).
• Kaynak branch: Yeni Branch'in hangi Branch'ten türetileceğini seçin. Varsayılan olarak master seçili gelir.

Alanları doldurduktan sonra CREATE butonuna tıklayın. Oluşturulan branch sol paneldeki Branch List'e eklenir; üzerine tıklayarak o branch'e geçiş yapabilirsiniz.

4. Branch Menüsü ve Ayarlar

Branch Menüsü (⋯ simgesi)

Branch List'teki bir Branch'in yanındaki ⋯ simgesine tıklandığında üç seçenek açılır:

• Rename branch: Seçili Branch'in adını değiştirir.
• Create new from this branch: Bu Branch'i kaynak alarak yeni bir branch oluşturur.
• Merge into another branch: Bu Branch'i başka bir Branch'le birleştirir.

Ayarlar Menüsü (⚙ dişli simgesi)

Branch Manager ekranının sağ üst köşesindeki ⚙ dişli simgesine tıklandığında iki seçenek sunulur:

• Merge to branch: Mevcut Branch'i hedef bir Branch'le birleştirir.
• Deactivate Version Control: Branch Manager'ı devre dışı bırakır. Bu işlem geri alınamaz.

Deactivate Branch Manager

Branch Manager'ı deaktive etmek geri alınamaz bir işlemdir. Deaktive etmek için sağ üst köşedeki ⚙ dişli simgesine tıklayın ve Deactivate Version Control seçeneğini seçin ve Deactive butonuna tıklayın.

Bu işlem gerçekleştiğinde: 

• Yalnızca master branch varlıkları korunur; diğer Branch'lerde oluşturulan ve hiç merge edilmemiş varlıklar silinir.
• Tüm commit edilmemiş değişiklikler atılır.
• Tüm Branch'ler ve commit geçmişi kalıcı olarak silinir.

5. Değişiklikleri İnceleme (Changes)

Changes sekmesi, bir branch üzerinde yapılan ve henüz commit edilmemiş değişiklikleri gösterir. Ekran tasarımı, data source, action ve diğer modüllerdeki değişiklikler bu sekmede izlenir. Sol panelde etkilenen ekran veya element listelenir; sağ tarafta seçili öğenin değişiklik detayları görüntülenir.

After / Before / Consolidated görünümleri

Değişiklik detay alanında üç sekme bulunur:

• After: Değişiklik sonrası durumu gösterir.

• Before: Değişiklik öncesi durumu gösterir. Değişen bölge yeşil çerçeve ile vurgulanır.
• Consolidated changes: Tüm değişiklikleri tek bir görünümde özetler.

Changelog Detay Paneli

Sağ üstteki Changes butonuna tıklandığında bir panel açılır. Bu panelde iki sekme bulunur:

• Consolidated: Tüm değişikliklerin Property / Before / After sütunlarıyla birleşik özetini gösterir.

• Changelogs (N): Her bir save işlemini tarih ve saat bilgisiyle listeler. Her kayıt için Revert veya Revert from #1 seçeneği sunar.

Değişikliği Geri Alma (Revert)

Commit etmeden önce yaptığınız değişiklikleri geri alabilirsiniz. Revert işlemi bir zaman çizelgesi mantığıyla çalışır: belirli bir save noktasını revert ettiğinizde o noktadan sonra yapılmış ve birbirine bağlantılı değişiklikler de birlikte geri alınır. Yalnızca tek bir değişikliği bağımsız olarak geri almak mümkün değildir.

Template Ekranlarda Otomatik Değişiklikler: Forgot Password, Authentication gibi hazır (template) ekranlara ilk kez girdiğinizde, herhangi bir şey değiştirmemiş olsanız da Changes sekmesinde otomatik değişiklikler listelenebilir. Bu değişiklikler, Kuika'nın yeni sürümlerinde template ekranlara eklenen Property'lerin projenize otomatik eklenmesinden kaynaklanır ve bir hata değildir. Bu değişiklikleri güvenle Commit All ile kabul edebilirsiniz.

6. Commit (Değişiklikleri Kaydetme)

Commit, yaptığınız değişiklikleri bir checkpoint (kontrol noktası) olarak kaydetme işlemidir. Commit edilen değişiklikler branch geçmişine eklenir ve istenildiğinde o noktaya geri dönülebilir.

Değişikliklerinizi kaydetmek için Changes sekmesindeki Commit All butonuna tıklayın.

Açılan Commit to Branch ekranında:

• Summary: Commit için anlamlı bir özet girin (örneğin Ana sayfa buton düzeltmesi). Bu alan zorunludur.
• Description: İsteğe bağlı olarak ek açıklama ekleyebilirsiniz.

Kaç öğenin commit edileceği diyalog altında bilgi olarak gösterilir. COMMIT butonuna tıklayarak işlemi tamamlayın.

"Commit" Terimi Hakkında: Kuika'daki commit kavramı, yazılım geliştirmede kullanılan Git ile benzer bir işlev görse de çalışma mantığı farklılıklar içerebilir. Git bilgisi olmayan kullanıcılar için: commit, yaptığınız değişikliklerin bir kayıt noktası oluşturması anlamına gelir.

7. Commit Geçmişi (Commits)

Commits sekmesi, branch üzerindeki tüm commit geçmişini kronolojik olarak listeler. Her commit satırında commit numarası (#1, #2, ...), özeti, Current ve Checkpoint etiketleri ile değişiklik sayısı görünür. Listeyi güncellemek için sağ üst köşedeki Refresh butonuna tıklayabilirsiniz.

Henüz hiç commit yapılmamış bir branch'te "No commits yet." mesajı görüntülenir.

8. Branch'leri Birleştirme (Merge)

Bir branch üzerindeki geliştirmeler tamamlandığında değişikliklerinizi başka bir Branch'e (genellikle master) aktarabilirsiniz.

Merge Sekmesi Üzerinden

Merge sekmesine geçin. Açılan ekranda aşağıdaki alanları doldurun:

• Target Branch: Birleştirme yapılacak hedef Branch'i seçin.
• Summary: Merge için açıklayıcı bir metin girin.
• Description: İsteğe bağlı ek açıklama ekleyebilirsiniz.

Alanları doldurduktan sonra Start Merge butonuna tıklayın.

Dal Menüsü Üzerinden

Branch List'teki Branch'in yanındaki ⋯ menüsünden Merge into another branch seçeneği seçilerek de aynı işleme başlanabilir.

9. Merge Sırasında Conflict (Çatışma) Yönetimi

Merge sırasında iki Branch'te aynı öğe üzerinde farklı değişiklikler yapılmışsa conflict (çatışma) oluşur. Conflict çözülmeden merge tamamlanamaz. Sol panelde 0 of N resolved (0%) şeklinde bir ilerleme göstergesi görünür.

Conflict olan öğeye tıklayın. Sağ panelde Target (hedef branch) ve Source (kaynak branch) sütunları açılır:

• Use Target: Hedef Branch'teki versiyonu kullanır.
• Use Source: Kaynak Branch'teki versiyonu kullanır.

Tüm Conflict'ler çözüldükten sonra Complete Merge butonu aktif hale gelir.

‍

Gelişmiş Önizleme Seçenekleri

• Focus Target: Hedef branch görünümüne odaklanır.
• Hide/Show Advanced Preview: Detaylı önizlemeyi gizler veya gösterir.
• Focus Source: Kaynak branch görünümüne odaklanır.
• Split 2-way: Her iki branch'i yan yana karşılaştırarak görüntüler.

Resolved Output

Resolve sekmesinde bir seçim yapıldıktan sonra Resolved Output sekmesine geçilerek çözümün çıktısı doğrulanabilir. Tüm Conflict'ler çözüldükten sonra Complete Merge butonuna tıklayarak merge işlemini tamamlayın.

Merge işlemi tamamlanmadan sayfadan ayrılmak isterseniz Cancel Merge butonuna tıklayın. Bu işlem conflict çözme sürecini iptal eder.

10. Branch'ler Arası Hızlı Geçiş

Sol alt köşede bulunan Branch Manager sekmesine gitmeden proje içinden herhangi bir anda branch değiştirebilirsiniz. Ekranın sol alt köşesindeki branch adına tıkladığınızda Branch Settings menüsü açılır; mevcut Branch'leriniz listelenir ve tek tıkla geçiş yapabilirsiniz.