Script Senkronizasyonu

Roblox Studio, Roblox projenizdeki kodu düzenlemek için yerleşik bir betik editörü sunar. Editör, linting, tip kontrolü, otomatik tamamlama ve işbirlikçi düzenleme gibi anahtar özellikler içerir.

Ancak, birçok geliştirici Visual Studio Code, Cursor, Sublime Text veya Notepad++ gibi tercih ettikleri bir metin editörüne veya entegre geliştirme ortamına (IDE) sahip. Popüler geliştirme ortamları genellikle Studio'da bulunmayan özellikler veya eklentilere sahiptir. Dış bir editör 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 tam tersine. Bu senkronizasyon, dış bir editörde (örneğin VS Code) bir betiği düzenleyebileceğiniz ve değişikliğin anında Studio'da görüneceği anlamına gelir.

Script Senkronizasyonunu Ne Zaman Kullanmalısınız

• Tercih ettiğiniz metin editörünü kullanmak veya kodu sürüm kontrolüne almak isterseniz ancak Studio'yu her şey için kullanmak isterseniz, Script Senkronizasyonu iyi bir tercihtir. Ayrıca, üçüncü taraf araçların genellikle yapmadığı Roblox'un yerleşik işbirliği araçlarıyla da çalışır.

  Script Senkronizasyonu mevcut Roblox projeleriyle de iyi çalışır, çünkü bu, projeyi yönetme şeklinizde toplam 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 isterseniz, üçüncü taraf araçlar (örneğin Rojo) daha iyi bir seçimdir.

Script Senkronizasyonunu Ayarlayın

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

2. Sağ tıklayın ve Script Senkronizasyonu ⟩ Dizine Senkronize Et seçeneğini belirleyin.

   

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

4. Studio'da klasöre yeniden 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 editöründe dizini açın.

   Alternatif olarak, Studio'da bireysel bir betiğe sağ tıklayıp Dış Editörde Aç seçeneğini seçebilirsiniz.

Bireysel betikleri senkronize edebilirsiniz, ancak klasörleri senkronize etmenizi şiddetle tavsiye ederiz; bir klasörü senkronize ettiğinizde, 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 editörünüze bir LSP uzantısı eklemek isteyeceksiniz.

Temel İpuçları

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

• Özelliklere veya etiketlere sahip betikleri senkronize etmeyin. Script Senkronizasyonu bunları göz ardı eder, bu da disk üzerindeki dosyalarınızı eski bir sürüm ile senkronize etmeye başlarsanız veri kaybına yol açabilir.

• Script Senkronizasyonu, betik adlarının dosya sisteminizle uyumlu olmasını gerektirir—aynı isimlerin veya desteklenmeyen karakterlerin olmaması gerekir. Studio bu tür bir sorunu tespit ederse bir hata iletisi gösterir ve senkronizasyona devam etmeden önce durumu çözmenizi ister.

• Studio kapalıyken senkronize edilen dosya veya klasörler değişirse, yerinizi yeniden açtığınızda Studio, durumu nasıl çözmek istersiniz diye size sorar.

• Yerel diskinizdeki üst düzey (veya "kök") bir örneği—başlangıçta senkronize ettiğiniz örneği—silmek, Studio'nun bir hata iletisi vermesine 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 belirleyin.
  2. Yerel diskinizden örneği silmek için Dosyayı sil veya Klasörü sil seçeneğini seçin.
  3. Studio'daki betiği veya klasörü silin.

  Senkronizasyonu kapatmadan Studio'da veya yerel diskinizde çocuk örneklerini silebilirsiniz ve silme işlemi beklediğiniz gibi senkronize edilir.

Bir dil sunucusu ayarlayın

Dil sunucuları, metin editörünüze otomatik tamamlama, tip kontrolü, "tanıma git" gibi dil özellikleri sağlar. VS Code için, Luau Dil Sunucusu'nu öneriyoruz.

Dil sunucusu protokolü (LSP) uzantıları, düzgün çalışmak için bir projenin veri modeli hiyerarşisini anlamaları gerekir. VS Code uzantısı, bu verileri sağlayan bir companion Studio eklentisi (Luau Dil Sunucusu Companion) ile birlikte gelir.

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

Önerilen uzantılar

• Roblox Luau LSP ve Luau Dil Sunucusu Companion - Dil özellikleri (yer üstü)
• selene - Statik kod analizi (linting)
• StyLua - Otomatik kod formatlama

Senkronizasyon kuralları

Bir klasörü disk üzerindeki çocukları ile senkronize ederken, Studio otomatik olarak çocuklar üzerindeki oluşturma, yeniden adlandırma, taşıma ve silme işlemlerini disk üzerindeki dosya ve klasörlerle senkronize eder. Bu yaklaşım, bireysel betikler üzerinde manuel olarak senkronizasyonu durdurup başlatmaya gerek kalmadan kodunuzu korumanızı sağlar.

Diskte, Script Senkronizasyonu birbirleriyle 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 uygundur.