Yerli Kod Oluşturma

Yerelleşik kod oluşturma için Luau desteği ile, deneyiminizdeki sunucu tarafı kodlar doğrudan Luau ün işlemci tarafından yürütülen makine kodu talimatlarına derlenebilir, normal olmayan birçok sayısal hesap işlemi olmadan için işleme hızını artırabilirsiniz. Bu özellik, sunucudaki bazı kodlar için işleme hı

Yerelleşikleri Etkifleştirme

Bir Script için kod oluşturma yeteneklerini etkinleştirmek için, üstteki komentarı ekleyin: --!native >

--!yerli

print("Hello from native code!")

Bu, kod üretimini kodun içindeki tüm işlevler için kullanılabilir kodu sağlar ve üst düzey kapsayıcı olarak, ifade edilirse, karlı olarak kabul edilir. Hiçbir ekstra değişiklik gerekmez; kodun doğrudan ifade edilmesi aynıdır. Luau dili ve tüm Roblox API'leri için tüm özellikleri desteklenir.

Alternatif olarak, bir bireysel işlev için yerel kod oluşturma yetkisini etkinleştirmek için @native özelliğine ekleyerek:

@native
local function f(x)
  return (x + 1)
end

En İyi Pratikler

Aşağıdaki ipuçları, kod doğumundan en çok yararlanmanızı sağlayacaktır:

• Bu özelliği Luau'nun doğrudan içinde yapılan çok sayıda hesap işleme içinde etkinleştirmek en iyisidir. Eğer tabloların ve özellikle buffer türlerinde çok sayıda matematiksel işlem varsa, özelliği etkinleştirmek iyi bir aday olabilir.

• Sadece fonksiyonları kodu derlenir. Üstteki kapsayıcı kod sıklıkla sadece bir kez çalıştırılır ve çoğu kez çağrılan işlevler kadar faydalı değildir. Her kare kadar çok kez çağrılan işlevler için işlevler için işlevler için işlevler için işlevler için işlevler için işlevler için işlevler için i

• Bir kodlama veya bir işlevin doğal derleme olmadan ne kadar süreceğini ölçmek önerilir, böylece onu kullanmanın en iyi olduğunu kararlaştırabilirsiniz. Kod Gizlice araç, performansı ölçmek için kodları izleyebilir.

• --!native yorumunu her skript içinde yerleştirmeyi denemek isteyebilir, ancak yerleşik kod yüklenmesinin bazı dezavantajları vardır:

  • Sunucunun başlatma süresini artırabilen kod derleme süresi gerekir.
  • Ekstra bellek, derlenmiş kodu depolamak için kullanılır.
  • Bir deneyimdeki toplam izin verilen kod miktarının sınırı vardır.

Bu sorunlar, @native özelliğinin akıllı kullanımıyla ele alınabilir.

Kodu Kaçırmak

Tüm özelliklerin yerli kod oluşturma etkinleştirilmiş olup olmadığına bağlı olarak aynı davranır, ancak bunlardan bazıları yerli olarak çalışmayabilir veya düzgün çalışmayabilir veya düzgün çalışmayabilir veya düzgün çalışmayabilir. Bunlar arasında şunlar var:

• Geriye uyulmayan getfenv() / setfenv() çağrılarının kullanımı.
• Niyet olmayan argelerle math.asin() gibi varsayılan çeşitli Luau işlevlerinin kullanımı.
• Yanlış yazılmış parametreleri yazılı fonksiyonlara geçiş yapmak, örneğin foo(true) çağrılırken foo olarak kullanılırken dikkatli olun. function foo(arg: string) kullanılırken daima doğru 2> yazılış şemaları2> kullanın.

Kodlayıcı profil kullanırken, işlevin normal versiyonuna göre kullanım süresini karşılaştırabilirsiniz. Bir --!native içindeki kod veya işaretlenmiş #number1 kodunun dışında içinde bulunan birkaç faktör dü- optimizasyonu tetikley

Tip Anotasyonlarını Kullanma

Kod yerelleştirme deneyleri, kod yollarını optimize etmek için belirli bir değişken için en olası tipi tahmin etmeye çalışır. Örneğiniz,

Yerli kod oluşturma herhangi bir yazdestekleyeceğinden, yanlış tahminler yanlış işlemleri tetikleyebilir ve bunun sonucunda daha yavaş kod çalıştırılır.

Bazı yaygın sorunları çözmek için, Luau işlev argümanlarına anotasyonlar yazıyor, ancak özellikle Vector3 argümanlarına anotasyon yapılması önerilir:

--!yerli

-- “v” bir tablo olması gerekir; işlev, tablo kontrolleri nedeniyle daha yavaş çalışır
local function sumComponentsSlow(v)
	return v.X + v.Y + v.Z
end

-- “v” bir Vector3 olarak ilan edilmiştir; vektörler için kod üretilir
local function sumComponentsFast(v: Vector3)
	return v.X + v.Y + v.Z
end

Stüdyo Aletleri

Aşağıdaki Studio araçları --!native 脚本leri ve 0>#number10> işlevleri için desteklenir.

Hata ayıklama

Genel debugging scriptleri desteklenir, ancak yerel/upvalues için görüntüler tamamlanmış olabilir ve yerel arazi kaynaklarından gelen görüntüler tamamlanmış olabilir.

Ayrıca, seçilmiş kodu derleme için bozulma noktaları yerleştirerek, bu işlevler için yerelleştirmeyi devre dışı bırakacaktır.

Kod Değerlendirici

In the Kod Gözücüsü , kodların doğal olarak <native> yanında gösteren işlevleri vardır:

Eğer bir işlev marki @native veya --!native içindeki bir number1 anotasyonunu gösteremezse, bu işlev 1> 4>kırık noktası4> yerleştirimi, kullanılan 7>teşvik edilmeyen

Luau Heap

Luau Heap profilinde, kullanıcı tarafından alınan bellek, grafikteki [native] elemanları olarak görüntülenir.

Boyut Analizi

Her yerelleşik olarak derlenmiş senaryo belleği tüketir. Kompilasyon büyüklüğü, derlenmiş kodun özel sınırına ulaştığında, yerelleşik derleme durur ve geri kalan kod yerelleşik olarak çalıştırılır. Bu, yerelleşik derleme için senaryoları dikkatlice seçmeniz gerektiğini gerektirir.

Belirli fonksiyonların ve kodların kaynağını izlemek için:

1. Make sure you're in Server view through the client/server toggle button.
2. Command Bar から debug.umpCodesize() を çağırın.

Çıkış penceresinde, kodlanmış olarak nokta nereye çağrıldığına kadar, belleği tüketen kodların toplam sayısını ve 1>kod boyutu1> sınırını göreceksiniz. Özeti takiben, kodlanmış her kodun kod boyutu limiti için bir tablosu görürsünüz.

Her kript için çıktı, derlenen fonksiyon sayısını ve kaynak kod belleği tüketimini gösterir. Her k fonksiyonu, sonra kod boyutu boyutu sırasıyla gösterilir ve kaynak kod tüketimini [anonymous] olarak gösterilir. Son sütun, kodun fonksiyon b

Sınırlar ve Troubleshooting

Belirli bir CPU için kodu özelleştirilmiş bir hale getirmek için ekstra depolama gerektirir. Ayrıca, karmaşık işlevler için optimizasyonlar çok fazla zaman alabilir. Dahili bir sınıra vurmak Studio'nun Çıkış penceresinde bir hata rapor edecektir, bunlar: