sco Scorpio
winget install --id=Scorpio.sco -e sco是c#实现的解释型脚本,是一种高效,轻量,可嵌入的脚本语言,语法类似javascript,类型为弱类型,通过使用基于栈的虚拟机解释字节码来运行.
README
Scorpio-CSharp
- author : while
- QQ群 : 245199668 加入QQ群
基础介绍
sco是c#实现的解释型脚本,是一种高效,轻量,可嵌入的脚本语言,语法类似javascript,类型为弱类型,通过使用基于栈的虚拟机解释字节码来运行.
- 脚本示例 ExampleScripts
- VSCode 基础语法提示插件 https://marketplace.visualstudio.com/items?itemName=while.scorpio
- nuget地址 https://www.nuget.org/packages/Scorpio-CSharp/
- 脚本语法 体验地址 http://www.fengyuezhu.com/static/projects/Scorpio-CSharp/scriptconsole/
- 脚本实现 Space Shooter 体验地址 http://www.fengyuezhu.com/static/projects/Scorpio-CSharp/unitysample/
- 脚本实现 Space Shooter 源码地址 https://github.com/qingfeng346/ScorpioUnitySample
- 码云地址 : http://git.oschina.net/qingfeng346/Scorpio-CSharp
安装 sco 命令行
方式一 手动安装
- 下载Release对应版本,解压添加到环境变量
方式二 自动安装
- windows 7, windows 8, MacOS, Linux 需要预先安装 PowerShell Core, 然后运行命令行
pwsh -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://qingfeng346.gitee.io/installsco.ps1'))"
- windows 10 直接运行命令行, 也可以安装 PowerShell Core 使用上面的方法安装
powershell.exe -Command "Invoke-Expression ((New-Object System.Net.WebClient).DownloadString('https://qingfeng346.gitee.io/installsco.ps1'))"
兼容的 .net 平台
- unity2018及以上
- .net framework 4.0 及以上
- .net standard 2.0 及以上
- .net core 2.0 及以上
- asp.net
- asp.net core
- mono
- xamarin
注意事项
-
脚本文本文件编码要改成 utf8 without bom (无签名的utf8格式)
-
使用 importType 函数引入一个c#类, 参数字符串请参考 Type.GetType, 类似
- TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly
- TopNamespace.Sub+Namespace.ContainingClass+NestedClass,MyAssembly
-
脚本内所有c#实例(除了bool,number,string,enum等基础类型) 均为引用, struct 变量也一样
-
event 对象 += -= 操作可以使用函数 add_[event变量名] remove_[event变量名] 代替
-
c# 扩展函数, 请先调用 importExtension("类型") 引用
-
Unity3d 使用 IL2CPP 后, 部分Unity3D的类或函数不能反射获取,请配置link.xml或者使用快速反射功能
-
genericMethod, genericType 函数在IL2CPP下生成未声明过的类型会报错
反射调用c#运算符重载函数
运算符号 | 反射名称 | 脚本是否支持直接调用 ----- | ---- | ---- + | op_Addition | 支持 - | op_Subtraction | 支持 * | op_Multiply | 支持 / | op_Division | 支持 % | op_Modulus | 支持 | | op_BitwiseOr | 支持 & | op_BitwiseAnd | 支持 ^ | op_ExclusiveOr | 支持 > | op_GreaterThan | 支持 >= | op_GreaterThanOrEqual | 支持 < | op_LessThan | 支持 <= | op_LessThanOrEqual | 支持 == | op_Equality | 支持 != | op_Inequality | 不支持, 脚本 != 会直接取反 == [] | get_Item(获取变量) | 支持 key 不为string的情况 [] | set_Item(设置变量) | 支持 key 不为string的情况
快速反射
-
快速反射类生成
- 使用命令行可以生成快速反射类文件,例子
sco fast -dll [dll文件路径] -class [class完整名] -output [输出目录] -
快速反射类使用
- 例如使用快速反射的类为 UnityEngine.GameObject , 生成的快速反射类则为ScorpioClass_UnityEngine_GameObject, 然后 c# 调用
Scorpio.Userdata.TypeManager.SetFastReflectClass(typeof(UnityEngine.GameObject), new ScorpioClass_UnityEngine_GameObject(script))
源码目录说明
- Scorpio 脚本引擎源码
- ScorpioExec 命令行 sco
- ScorpioReflect 快速反射机制的实现
- ScorpioTest Unity3D内使用sco脚本示例
Unity相关
-
支持的Unity版本
- Unity2018及以上
- 请设置 PlayerSetting 内 Api Compatibility Level 为 .NET Standard 2.0
-
支持的Unity平台:
- PC, Mac & Linux Standalone(包括IL2CPP)
- iOS(包括IL2CPP)
- Android(包括IL2CPP)
- UWP(仅支持IL2CPP)
- WebGL
-
Unity导入Scorpio-CSharp:
- 复制源码目录 Scorpio/src 到Unity项目即可
捐助作者
