Aracılığıyla paylaş


Yeni kod ve belgeler geliştirme

Erişim düzeyine bağlı olarak, yeni kod ve belgeler yeni bir özellik dalında veya çatalda geliştirilebilir. Genel olarak, ayrı bir çataldan çalışmak tercih edilir ve bazen tek alternatiftir.

Git/GitHub geliştirmesinde en iyi yöntemler bu belgelerin kapsamı dışındadır, ancak daha fazla bilgi için buraya ulaşabilirsiniz.

Yeni kod

Çekme isteği gönderme (PR)

Herhangi bir çekme isteği, CI derleme işlem hattında el ile çalıştırma içermelidir. İşlem hattı, çekme isteğine bir açıklama eklenerek tetikleniyor. Aşağıdaki komut tam derlemeyi tetikler:

/azp run

Değişikliklerin tamamen kod veya belgelerle sınırlı olduğu biliniyorsa, derlemenin yalnızca bu tarafı çalıştırılabilir. Örneğin, yalnızca kod değişikliklerini denetlemek için:

/azp run wlt_ci

Veya yalnızca belge değişikliklerini denetlemek için:

/azp run wlt_docs

Ancak, kod (.cs) dosyalarıyla sınırlı değişikliklerin bile belge değişikliklerini tetikleyebileceğini unutmayın. Derlemenin tamamını çalıştırmak her zaman daha güvenlidir.

Çekme isteğinde yapılan önemli değişikliklerden sonra ve çekme isteğinin son tamamlanmasından önce uygun sürümü çalıştırın. Unutmayın, katkıda bulunanları derlemeyi bozmaya karşı korumak için bu araçlar mevcuttur. Bunları kullanmak kendi yararınıza ve aynı alanda çalışan diğer kişilerin yararınadır.

Kod gözden geçirme

Tüm PR'ler tamamlanmadan önce başka bir geliştirici tarafından gözden geçirilmelidir.

Kod incelemeleri yaparken, samimi ve işbirliğine dayalı bir atmosfer sağlayın. Diğer tarafın değişiklikler hakkında olumlu hissetmesini sağlayan bir öneri veya düzeltmeyi ifade etmenin bir yolunu bulmak her zaman biraz fazla zaman alır.

Yeni bir sürüm yayımlama

Kapsamlı test ve sabitleme sonrasında ürünün yeni bir güvenli sürümü yayımlanabilir.

Ürün iki kanal üzerinden kullanılabilir hale getiriliyor:

  1. Doğrulanmış yayın işlemeleri için etiketlenmiş açık kaynak GitHub deposu aracılığıyla.
  2. Yayımlanan .unitypackage dosyalar aracılığıyla.

Her iki kanal da WLTU'nun GitHub sürümleri sayfasında bulunur.

Unity paketlerini oluşturma

NOT: Burada açıklanan işlemin tam kullanıcı arabirimi sık sık değiştirilebilir. Ekranınızda gördükleriniz buradaki ekran görüntüleriyle eşleşmiyorsa, büyük olasılıkla sorun olmaz. Yalnızca ilgili anahtar sözcükleri arayın ve devam edin.

  1. İlk olarak derleme işlem hattı sayfasına gidin. "wlt_ci" öğesinin seçili olduğundan emin olun.

  2. Yayın için temel olacak işlemeyle eşleşen derlemeyi seçin.

    Derlemeyi seçin

  3. Bu seçim, derleme yapıtlarına erişilebilen aşağıdaki ekrana yol açar.*

    Derleme yapıtlarını bulma

  4. Unity paketlerini seçin.

    Unity paketlerini seçme

  5. Ardından zip olarak indirin.

    Unity paketlerini zip dosyası olarak indirme

  6. Paketleri yükledikten ve test ettikten sonra yeni bir sürümle tümleştirilebilirler.

Sürümü oluşturma

Koddaki Sürüm alanını güncelleştirme

WorldLockingManager.Version alanını yeni sürümü düzgün yansıtacak şekilde güncelleştirin.

Yayın dalı oluşturma

Örneğin, "release/v0.3.6-alpha" adlı bir dal oluşturun. Etiketle yedekli olsa da, bu dal yayında sık erişimli düzeltmeleri kolaylaştıracak ve bu da ana geliştirme dalı "master" için uygun olmayacaktır.

Yayını yayımlama

Unity sürümleri için Dünya Kilitleme Araçları sayfasına gidin.

"Yeni sürüm oluştur" düğmesine tıklayın.

Bir etiket belirtin. Etiketin vX.Y.Z[-prerelease-modifier] biçiminde olması gerekir. Bu etiketin X, Y ve Z değerleri, WorldLockingManager.Version alanında belirtilen sürümle eşleşmesi gereken üç tamsayıdır. Bu sayılar yayın dalının adıyla da eşleşmelidir.

Hedef olarak yukarıda oluşturulan yayın dalını belirtin.

Başlık ve açıklama alanlarını uygun şekilde doldurun.

.unitypackage Yukarıda oluşturulan dosyaları "buraya bırakarak veya seçerek ikili dosya ekle" etiketli dikdörtgene sürükleyin.

MRTK bağımlılığının anlık görüntüsünü de içeren büyük Örnekler paketinin karşıya yüklenmesi çok zaman alabilir. Karşıya yükleme başarıyla tamamlanana kadar bu sayfadan ayrılmamak en güvenlidir.

.unitypackage Dosyalar başarıyla karşıya yüklendikten sonra Yayını Yayımla düğmesine tıklayın.

Sürümler sayfasında her şeyin doğru göründüğünden emin olun.