xLua用白名單來指明生成哪些代碼，而白名單通過attribute來配置，比如你想從lua調(diào)用c#的某個類，希望生成適配代碼，你可以為這個類型打一個LuaCallCSharp標(biāo)簽：

[LuaCallCSharp]??

public?class?A??

{??

} ?

有時我們無法直接給一個類型打標(biāo)簽，比如系統(tǒng)api，沒源碼的庫，或者實例化的泛化類型，這時你可以在一個靜態(tài)類里聲明一個靜態(tài)field或者靜態(tài)property，該字段的類型除BlackList和AdditionalProperties之外只要實現(xiàn)了IEnumerable就可以了（這兩個例外后面具體會說），然后為這字段加上標(biāo)簽：

[LuaCallCSharp] ?

public?static?Listmymodule_lua_call_cs_list?=?new?List()??

{??

typeof(GameObject),??

typeof(Dictionary),??

}; ?

XLua.LuaCallCSharp

一個C#類型加了這個配置，xLua會生成這個類型的適配代碼（包括構(gòu)造該類型實例，訪問其成員屬性、方法，靜態(tài)屬性、方法），否則將會嘗試用性能較低的反射方式來訪問。

一個類型的擴展方法（Extension Methods）加了這配置，也會生成適配代碼并追加到被擴展類型的成員方法上。

xLua只會生成加了該配置的類型，不會自動生成其父類的適配代碼，當(dāng)訪問子類對象的父類方法，如果該父類加了LuaCallCSharp配置，則執(zhí)行父類的適配代碼，否則會嘗試用反射來訪問。

反射訪問除了性能不佳之外，在il2cpp下還有可能因為代碼剪裁而導(dǎo)致無法訪問，后者可以通過下面介紹的ReflectionUse標(biāo)簽來避免。

XLua.ReflectionUse

一個C#類型類型加了這個配置，xLua會生成link.xml阻止il2cpp的代碼剪裁。

對于擴展方法，必須加上LuaCallCSharp或者ReflectionUse才可以被訪問到。

建議所有要在Lua訪問的類型，要么加LuaCallCSharp，要么加上ReflectionUse，這才能夠保證在各平臺都能正常運行。

XLua.CSharpCallLua

如果希望把一個lua函數(shù)適配到一個C#delegate（一類是C#側(cè)各種回調(diào)：UI事件，delegate參數(shù)，比如List:ForEach；另外一類場景是通過LuaTable的Get函數(shù)指明一個lua函數(shù)綁定到一個delegate）。或者把一個lua table適配到一個C# interface，該delegate或者interface需要加上該配置。

XLua.GCOptimize

一個C#純值類型（注：指的是一個只包含值類型的struct，可以嵌套其它只包含值類型的struct）或者C#枚舉值加上了這個配置。xLua會為該類型生成gc優(yōu)化代碼，效果是該值類型在lua和c#間傳遞不產(chǎn)生（C#）gc alloc，該類型的數(shù)組訪問也不產(chǎn)生gc。各種無GC的場景，可以參考05_NoGc例子。

除枚舉之外，包含無參構(gòu)造函數(shù)的復(fù)雜類型，都會生成lua table到該類型，以及改類型的一維數(shù)組的轉(zhuǎn)換代碼，這將會優(yōu)化這個轉(zhuǎn)換的性能，包括更少的gc alloc。

XLua.AdditionalProperties

這個是GCOptimize的擴展配置，有的時候，一些struct喜歡把field做成是私有的，通過property來訪問field，這時就需要用到該配置（默認(rèn)情況下GCOptimize只對public的field打解包）。

標(biāo)簽方式比較簡單，配置方式復(fù)雜一點，要求是Dictionary>類型，Dictionary的Key是要生效的類型，Value是屬性名列表。可以參考XLua對幾個UnityEngine下值類型的配置，SysGCOptimize類。

XLua.BlackList

如果你不要生成一個類型的一些成員的適配代碼，你可以通過這個配置來實現(xiàn)。

標(biāo)簽方式比較簡單，對應(yīng)的成員上加就可以了。

由于考慮到有可能需要把重載函數(shù)的其中一個重載列入黑名單，配置方式比較復(fù)雜，類型是List

例如下面是對GameObject的一個屬性以及FileInfo的一個方法列入黑名單：

[BlackList] ?

public?static?List>?BlackList?=?new?List>()??{??

new?List(){"UnityEngine.GameObject",?"networkView"},??

new?List(){"System.IO.FileInfo",?"GetAccessControl",?"System.Security.AccessControl.AccessControlSections"},??

}; ?

下面是生成期配置，必須放到Editor目錄下 CSObjectWrapEditor.GenPath

配置生成代碼的放置路徑，類型是string。默認(rèn)放在“Assets/XLua/Gen/”下。

CSObjectWrapEditor.GenCodeMenu

該配置用于生成引擎的二次開發(fā)，一個無參數(shù)函數(shù)加了這個標(biāo)簽，在執(zhí)行“XLua/Generate Code”菜單時會觸發(fā)這個函數(shù)的調(diào)用。