Generazione del codice nativo

Con il supporto di Luau per la generazione del codice nativo, gli script lato server nella tua esperienza possono essere compilati direttamente nelle istruzioni del codice macchina che le CPU eseguono, piuttosto che il bytecode regolare che la VM Luau esegue.Questa funzione può essere utilizzata per migliorare la velocità di esecuzione per alcuni script sul Server, in particolare quelli che hanno molte operazioni numeriche senza utilizzare troppi richiami di libreria Luau pesanti o chiamate API di Roblox.

Abilita la generazione del codice nativo

Per abilitare la generazione del codice nativo per un Script , aggiungi il commento --!native in cima:¹

--!native

print("Hello from native code!")

Questo consente la generazione del codice nativo per tutte le funzioni nello script e la scoperta di alto livello, se ritenuta redditizia.Non sono richeste modifiche aggiuntive; il comportamento degli script in esecuzione nativa è esattamente lo stesso di prima e solo le prestazioni sono diverse.Tutte le funzionalità della lingua Luau e tutte le API Roblox rimangono supportate.

In alternativa, puoi abilitare la generazione del codice nativo per una funzione individuale aggiungendo l'attributo @native :

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

Migliori pratiche

I seguenti suggerimenti ti aiuteranno a trarre il maggior beneficio dalla generazione del codice nativo:

• È meglio abilitare questa funzione all'interno degli script che eseguono molte operazioni direttamente all'interno di Luau.Se hai molte operazioni matematiche su tabelle e in particolare buffer tipi, lo script può essere un buon candidato.

• Solo le funzioni dello script sono compilate in modo nativo.Il codice nella parte superiore esterna ambito è spesso eseguito solo una volta e non beneficia tanto quanto le funzioni che vengono chiamate molte volte, in particolare quelle che vengono chiamate ogni frame.

• Si consiglia di misurare il tempo che uno script o una funzione richiede con e senza compilazione nativa per giudicare quando è meglio usarlo.Lo strumento Profilatore di script può misurare le prestazioni delle funzioni per prendere decisioni informate.

• Può essere tentante posizionare il commento --!native in ogni script solo nel caso che alcuni di essi verranno eseguiti più rapidamente, ma la generazione del codice nativo ha alcuni difetti:

  • È richiesto il tempo di compilazione del codice che può aumentare il tempo di avvio dei server.
  • La memoria extra è occupata per archiviare codice compilato nativamente.
  • C'è un limite sull'importo totale consentito di codice compilato nativamente in un'esperienza.

Questi problemi possono essere affrontati con un uso giudizioso dell'attributo @native.

Codice da evitare

Mentre tutte le funzionalità si comporteranno allo stesso modo con o senza la generazione di codice nativo abilitata, alcune di esse non si eseguiranno native e potrebbero causare una de-ottimizzazione o un ricorso all'esecuzione interpretata.Queste includono:

• Uso di chiamate deprecate getfenv() / setfenv() .
• Uso di diverse funzioni integrate di Luau come math.asin() con argomenti non numerici.
• Passare parametri impropriamente tipizzati a funzioni tipizzate, ad esempio chiamando foo(true) quando foo è dichiarato function foo(arg: string) .Ricorda di usare sempre le annotazioni di tipo corretto .

Quando si utilizza il Profilatore di script, puoi confrontare il tempo impiegato da una versione regolare della funzione rispetto a quella compilata inizialmente.Se una funzione all'interno di uno script non sembra essere eseguita in modo nativo, uno o più fattori dalla lista sopra possono attivare la de-ottimizzazione.

Usa le annotazioni di tipo

Gli tentativi di generazione del codice nativo cercano di inferire il tipo più probabile per una variabile data per ottimizzare i percorsi del codice.Ad esempio, si presume che a + b venga eseguito sui numeri, o che una tabella venga accessata in t.X .Dato l'ipercarico dell'operatore, tuttavia, a e b possono essere tabelle o Vector3 tipi, o t possono essere un tipo di dati Roblox.

Mentre la generazione del codice nativo supporterà qualsiasi inserisci / scrivi, le previsioni errate possono attivare controlli non necessari, causando un'esecuzione del codice più lenta.

Per risolvere alcuni problemi comuni, viene controllata l'annotazione Luau sul tipo di argomenti della funzione, ma è particolarmente raccomandato annotare gli argomenti Vector3 :

--!native

-- si presume che "v" sia una tabella; la funzione si esegue più lentamente a causa dei controlli della tabella
local function sumComponentsSlow(v)
	return v.X + v.Y + v.Z
end

-- ""v" è dichiarato essere un Vector3; viene generato un codice specializzato per i veicoli
local function sumComponentsFast(v: Vector3)
	return v.X + v.Y + v.Z
end

Strumentazione dello studio

La seguente attrezzatura Studio è supportata per --!native script e @native.

Debuggenza

La generale debugging degli script è supportata, ma le viste per gli insider/upvalues possono essere incomplete e mancare le variabili dalla call stack frame che vengono eseguite in modo nativo.

Si noti inoltre che quando si debugga il codice selezionato per la compilazione nativa, posizionare punti di interruzione disabiliterà l'esecuzione nativa per quelle funzioni.

Profilatore di script

Nel Profilatore di script, le funzioni che eseguono in modo nativo visualizzano <native> accanto a loro:

Se una funzione contrassegnata @native o all'interno di uno script --!native non mostra l'annotazione <native> , quella funzione potrebbe non essere eseguita in modo nativo a causa del posizionamento punto di interruzione , dell'uso del codice scoraggiato o delle annotazioni di tipo diverso.

Pila di Luau

Nel profilatore Luau heap le memorie prese dalle funzioni native vengono visualizzate come [native] elementi nel grafico.

Analisi delle dimensioni

Ogni script compilato nativamente consuma memoria.Quando la dimensione del codice compilato raggiunge un limite predefinito, la compilazione nativa si ferma e il codice rimanente viene eseguito non nativamente.Questo rende essenziale scegliere attentamente gli script per la compilazione nativa.

Per monitorare la dimensione del codice nativo delle singole funzioni e script:

1. Assicurati di essere nella vista Server attraverso il pulsante client/server toggle.
2. Invoca debug.dumpcodesize() dal Comando Bar.

Nella finestra Output, vedrai il numero totale di script e funzioni che sono stati compilati nativamente fino al punto di invocazione, la memoria consumata dal loro codice nativo e il limite delle dimensioni del codice nativo.Dopo il Sommario, vedrai una tabella per ogni script compilato nativamente in ordine crescente della dimensione del codice.

Per ogni script, l'output visualizza il numero di funzioni compilate e il consumo di memoria del codice nativo.Ogni funzione viene quindi elencata in ordine decrescente della dimensione del codice nativo, con funzioni anonime mostrate come [anonymous] e script completi mostrati come [top level].Nella colonna finale, la percentuale viene calcolata rispetto al limite delle dimensioni del codice nativo.Si noti che la dimensione del codice nativo delle funzioni viene riportata con precisione, ma il consumo di memoria per gli script viene arrotondato alla dimensione della pagina più vicina.

Limitazioni e risoluzione dei problemi

La compilazione del codice in istruzioni per una particolare CPU richiede ulteriori memorie di archiviazione.Inoltre, le ottimizzazioni per funzioni complesse possono richiedere troppo tempo per essere eseguite.Colpire un limite interno riporterà un errore nella finestra Output di Studio, incluso: