Script Senkronizasyonu

Roblox Studio, Roblox projenizdeki kodu düzenlemek için yerleşik bir betik düzenleyici içerir. Düzenleyici, linting, tür kontrolü, otomatik tamamlama ve işbirlikçi düzenleme gibi temel özellikleri içerir.

Ancak birçok geliştirici, Visual Studio Code, Cursor, Sublime Text veya Notepad++ gibi tercih ettikleri bir metin düzenleyici veya entegre geliştirme ortamına (IDE) sahiptir. Popüler geliştirme ortamları genellikle Studio'da bulunmayan özellikler veya eklentiler içerir. Studio ile bir dış düzenleyici veya IDE kullanmak için Script Senkronizasyonu özelliğini etkinleştirin.

Script Senkronizasyonu, veri modelinizdeki betikleri yerel diskinizdeki metin dosyalarıyla senkronize ederek çalışır. Diskteki Luau dosyalarında yapılan değişiklikler Studio'daki betiklere uygulanır ve tersine. Bu senkronizasyon, bir dış düzenleyicide (örneğin VS Code) bir betiği düzenleyebileceğiniz ve değişikliği hemen Studio'da görebileceğiniz anlamına gelir.

Script Senkronizasyonunu Ne Zaman Kullanmalısınız

• Tercih ettiğiniz metin düzenleyicisini kullanmak veya kodu sürüm kontrolüne almak istiyorsanız, ancak diğer her şey için Studio'yu kullanmak istiyorsanız, Script Senkronizasyonu iyi bir seçimdir. Ayrıca, üçüncü taraf araçların genellikle desteklemediği Roblox'un yerleşik işbirliği araçları ile de çalışır.

  Script Senkronizasyonu, mevcut Roblox projeleriyle iyi çalışır, çünkü bu, projenizi yönetme şeklinizde tam bir değişiklikten ziyade ek bir özelliktir.

• Projenizin tamamını (sadece kod değil) sürüm kontrolüne almak veya dosya sisteminizi projeniz için gerçek kaynak olarak kullanmak istiyorsanız, üçüncü taraf araçlar (örneğin Rojo) daha iyi bir seçimdir.

Script Senkronizasyonunu Ayarlama

1. Explorer'da senkronize etmek istediğiniz bir veya daha fazla klasörü seçin.

2. Sağ tıklayın ve Senkrone Et... seçeneğini seçin.

   

3. Bilgisayarınızdaki bir dizini seçin (veya yeni bir tane oluşturun) ve Kaydet'e tıklayın.

4. Studio'da, klasöre tekrar sağ tıklayın ve Script Senkronizasyonu ⟩ Explorer'da Göster (Windows) veya Finder'da Göster (macOS) seçeneğini seçin.

5. Tercih ettiğiniz metin düzenleyicisinde dizini açın.

   Alternatif olarak, Studio'daki bireysel bir betiğe sağ tıklayıp Dış Düzenleyicide Aç seçeneğini seçebilirsiniz.

Bireysel betikleri senkronize edebilirsiniz, ancak klasörleri senkronize etmeyi şiddetle öneririz; bir klasörü senkronize ederseniz, Script Senkronizasyonu otomatik olarak alt klasörlerini ve betiklerini senkronize eder, bu da betikleri her seferinde senkronize etmeye gerek kalmadan oluşturmanıza, silmenize ve yeniden adlandırmanıza olanak tanır.

Script Senkronizasyonunu ayarladıktan sonra, muhtemelen metin düzenleyicinize bir LSP uzantısı eklemek istersiniz.

Sınırlamalar

Script Senkronizasyonu, her üst düzey senkronize edilmiş örnek için 10.000 betiğe ve 128 üst düzey senkronize edilmiş örneğe kadar destekler, bu nedenle büyük kod tabanlarına ölçeklenebilir.

Çatışma Çözümü

Senkronizasyonu başlatırken veya yeniden başlatırken, Studio ile disk üzerindeki dosyalarınız arasında farklılıklar varsa, Script Senkronizasyonu ayrıntılı bir çözüm iletişim kutusu gösterir. İletişim kutusu, her iki tarafta hangi betiklerin ekleneceğini, değiştirileceğini veya silineceğini listeler, böylece Studio'yu Koruyun ile Diski Koruyun seçeneğini seçmenin etkisini anlayabilirsiniz.

Seçici Silme

Studio'da veya disk üzerinde senkronize edilmiş bir betiği veya klasörü sildiğinizde, Script Senkronizasyonu yalnızca Luau betiklerini ve desteklenen dosyaları kaldırır. Yönetmediği Luau dışı dosyaları veya klasörleri silmez; modeller ve parçalar gibi betik olmayan varlıklar, senkronize edilmiş öğeleri etraflarında kaldırdığınızda veya yeniden düzenlediğinizde bile korunur.

Takım Oluşturma

Script Senkronizasyonu, Takım Oluşturma ile çalışır. Explorer, bir işbirlikçinin şu anda senkronize ettiği örneklerde bir simge gösterir. Aynı isimlerin tekrarını önlemek için, Script Senkronizasyonu, sizin veya bir işbirlikçinin senkronize ettiği bir ağaç altında eklenen yeni örneğin adına otomatik olarak sayısal bir ek ekler.

Birden fazla kişinin aynı betiği senkronize edip dosyaları aynı anda düzenlediği iş akışlarından kaçının. Script Senkronizasyonu çalışmaya devam edecektir, ancak işbirlikçiler birbirlerinin değişikliklerini geçersiz kılabilir.

Ana İpuçları

• Script Senkronizasyonu yalnızca Script, LocalScript, ModuleScript ve Folder örneklerini senkronize eder. Senkronize bir klasördeki diğer tüm örnekler göz ardı edilir. Betiklerin diğer örneklerle birlikte bulunduğu klasörleri senkronize etmekten kaçının.

• Paketleri senkronize edebilirsiniz, ancak PackageLink kendisi diske yazılmaz.

• Özellikleri veya etiketleri olan betikleri senkronize etmeyin. Script Senkronizasyonu bunları göz ardı eder, bu da disk üzerindeki dosyalarınızın daha eski bir sürümüyle senkronize etmeye başladığınızda veri kaybına yol açabilir.

• Script Senkronizasyonu, betiklerin adlarının dosya sisteminizle uyumlu olmasını gerektirir—tekrarlayan isimler veya desteklenmeyen karakterler olmamalıdır. Studio bu sorunlardan herhangi biriyle karşılaşırsa, bir hata fırlatır ve senkronizasyonu yeniden başlatmadan önce durumu çözmenizi ister.

• Studio kapalıyken senkronize edilmiş dosya veya klasörlerden herhangi biri değişirse, yerinizi yeniden açtığınızda Studio size durumu nasıl çözmek istediğinizi sorar.

• Yerel diskinizdeki üst düzey (veya "kök") bir örneği—ilk senkronize ettiğiniz örneği—silmek, Studio'nun bir hata fırlatmasına neden olabilir. Üst düzey bir örneği silmek için:

  1. Studio'da, betiğe veya klasöre sağ tıklayın ve Script Senkronizasyonu ⟩ Senkronizasyonu Durdur seçeneğini seçin.
  2. Örneği yerel diskinizden silmek için Dosyayı Sil veya Klasörü Sil seçeneğini seçin.
  3. Studio'daki betiği veya klasörü silin.

  Senkronizasyonu devre dışı bırakmadan Studio'da veya yerel diskinizde alt örnekleri silebilirsiniz ve silme, beklediğiniz gibi senkronize edilir.

Bir dil sunucusu ayarlama

Dil sunucuları, metin düzenleyicinize otomatik tamamlama, tür kontrolü, "tanıma git" ve daha fazlası gibi dil özel özellikler sağlar. VS Code için, Luau Dil Sunucusu'nu öneriyoruz.

Dil sunucusu protokolü (LSP) uzantıları, düzgün çalışabilmesi için bir projenin veri modeli hiyerarşisini anlamalıdır. VS Code uzantısı, bu veriyi sağlayan bir Studio eklentisiyle birlikte gelir (Luau Dil Sunucusu Companion).

Her ikisini de yüklemenizi şiddetle öneririz. VS Code uzantısını ve companion Studio eklentisini kullanıyorsanız, Script Senkronizasyonu kullanırken dil özellikleri VS Code'da doğru çalışacaktır.

Önerilen uzantılar

• Roblox Luau LSP ve Luau Dil Sunucusu Companion - Dil özellikleri (yukarıya bakın)
• selene - Statik kod analizi (linting)
• StyLua - Otomatik kod biçimlendirme

Senkronizasyon Kuralları

Bir örneği çocuklarıyla birlikte disk üzerindeki bir dizinle senkronize ederken, Studio otomatik olarak çocuklardaki oluşturma, yeniden adlandırma, taşıma ve silme işlemlerini disk üzerindeki karşılık gelen dosyalar ve klasörlerle senkronize eder. Bu yaklaşım, bireysel betikler üzerinde manuel olarak senkronizasyonu durdurup başlatmadan kodunuzu korumanıza olanak tanır.

Diskte, Script Senkronizasyonu, farklı betik türlerini birbirinden ayırt etmek için aşağıdaki kuralları kullanır.

Ayarlar

Script Senkronizasyonu, Studio Ayarları penceresinde birkaç ayara sahiptir (AltS veya ⌥S). Varsayılan seçenekler, çoğu kullanım durumu için iyi bir uyum sağlar.