使用JSPWiki丰富Unity-UPM包的使用
1.简述
诸如npm、Nuget之类的包管理工具，Unity推出了自己的Unity Package Manager(UPM)工具来管理使用到的第三方库。
现在Unity Package Manager可以直接允许我们导入git仓库进行链接。
2.UPM库的配置与链接
通过Unity官方文档的教程可进行UPM库的配置与链接的参考:
https://docs.unity3d.com/Manual/CustomPackages.html
这里以Unity 2019.4.3f1为例，创建一个名为Test1的文件夹作为测试。根据官方提供的文件夹规则，
创建Runtime文件夹并将具体脚本及资源文件置于其中。
随后在Runtime文件夹中创建asmdef文件，该文件可以将文件夹内的部分打包进单独的动态资源库。
asmdef文件可以通过Project面板中右键Create->Assembly Definition进行创建。
根据上述文件夹规则，接下来创建package.json文件，Unity在得到库的git地址后，会查找该文件获取配置信息。
目前版本的unity对git仓库引用的包支持有限，在包体描述中不能插入URL超链接或是文档链接，但支持Sample案例资源的
配置与导入。这里示范的package.json配置如下：
{ "name": "com.test.test1", "displayName": "test1", "description": "This is test package", "version": "1.0.0", "unity": "2019.4", "unityRelease": "3f1", "author": { "name": "hont", "url": "your url" }, "keywords": [ "test" ], "type": "library", "samples": [ { "displayName": "Sample1", "description": "This Sample1", "path": "Samples~/demo1" }, { "displayName": "Sample2", "description": "This Sample2", "path": "Samples~/demo2" }, { "displayName": "Sample3", "description": "This Sample3", "path": "Samples~/demo3" } ] }
其具体规则在unity文档中可进行查看，不多赘述。
注:name内的名称不能有大写，否则导入报错
最后新建ReadMe.md文件，供网页浏览git库时查看。
配置好之后其文件夹结构如下：
将Test1这个文件夹拿出来，把里面的内容上传至git仓库即可，注意需要包含meta文件。
这里用到的内网git工具为gitblit，同样部署在tomcat里即可，很方便。
上传至git仓库后，在Package Manager面板点击左上角加号，以添加git库。
点击后即可导入。
3.配置JSPWiki提供公共目录页
3.1 JSPWiki简述
在资源上传内网git后，由于不知道库的地址及使用说明，
大家在使用时仍不太方便，虽然也可以通过gitlab的wiki页或是confluence之类的工具，
但这里使用JSPWiki这个非常轻量的Wiki创建工具来制作页面，
并提供每一个库的地址和说明。
JSPWiki的配置非常简单，放入Tomcat即可运行，甚至不需要配置数据库，且支持简单的图片上传等功能。如下图：
3.2 安装JSPWiki
这里用到的环境为：
- apache-tomcat-7.0.105
- JSP Wiki 2.11.0.M3
先去JSP Wiki官网下载war包：
https://jspwiki-wiki.apache.org/
2.11.0 M3镜像地址:
https://archive.apache.org/dist/jspwiki/2.11.0.M3/
一路点进/binaries/webapp/JSPWiki.war下载即可。
然后进行tomcat的安装，下载地址:
https://tomcat.apache.org/download-70.cgi
解压后需要配置环境变量到对应路径，并且需要安装对应版本JDK。
具体教程资源在网络上较多，不多说明。如果内网服务器已经有tomcat就方便多了。
运行bin/startup.bat即可启动tomcat，默认端口为8080，即:
http://127.0.0.1:8080/
测试后若打开了tomcat的默认网页即为安装成功。
将JSPWiki.war放入tomcat的webapps目录内，再次运行tomcat即可自动解压。
再去根据webapps的文件夹名进行访问，例如：
http://127.0.0.1:8080/JSPWiki/
可进入JSPWiki的初始界面。
这样就安装好了。
3.3 配置管理员权限
如果没有管理员权限则无法对附件、Wiki页等进行删除操作。
安装JSPWiki后默认会生成一个管理员账号，密码随机。但是有时候也不一定会跳出这个配置页面，
此时可通过修改xml文件来强行设置管理员。
首先点击右上角登录，新建一个账号：
这里以新账号test1为例，进入JSPWiki\WEB-INF目录。打开groupdatabase.xml修改为：
<?xml version="1.0" encoding="UTF-8"?> <groups> <group name="Admin" creator="hont" created="2020.08.09 at 09:55:04:612 GMT+08:00" modifier="hont" lastModified="2020.08.09 at 09:55:04:612 GMT+08:00"> <member principal="test1" /> </group> </groups>
即可将test1加入管理员用户组。
3.4 编写wiki
我们可以通过直接访问需要的目录页来编写wiki，例如：
http://127.0.0.1:8081/JSPWiki/Wiki.jsp?page=Lib_InputSystem
此时会提示目录页不存在，点击创建即可。
编辑时点击编辑器的水滴图标可进行加粗、插入图片等常规操作：
也有类似md的语法，基础格式语法如下：
---- 水平线 // 换行符<BR> [link] 插入超链接"link", "link"可以是一个内部Wiki名
或者是一个外部链接(http://) [text|link] 创建一个超链接, 链接采用text的描述进行显示. [text|wiki:link] 创建一个超链接, 链接采用text的描述进行显示，并且链接指向一个内部Wiki名. [attached_image] 用来嵌入一个图片。前题是这个图片要先作为附件上传。
"attached_image"代表这个附件图片名. * 创建一个项目列表. 如果是多个(**)符号，代表下一层次的缩进项目列表. # 创建一个编号项目列表. 可以多层次(##, ###)缩进. !, !!, !!! 用一个感叹号(!)开头的行可以表示一个标题. 多个感叹号代表更大的标题 __text__ 使文本text为粗体. ''text'' 使文本text为斜体(注意是采用两个单引号) {{text}} 使文本text为等宽字体. ;term:def 用'def'定义一个条目'term'. Use this with
empty 'term' to make short comments. |text|more text| 创建一个表格. 如果是表头则采用双竖线.
%%(color:red;background-color:blue)my text/% 使用css样式
通过右上角信息选项下的附件按钮，可以插入图片或其他一些内容：
再对图片的URL进行引用，即可在wiki中使用图片。
需要注意上传图片名不能为中文，如果要上传带中文名的图片需要修改tomcat中
server.xml的标签，加入URIEncoding="UTF-8"：
<Connector port="8081" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
3.5 wiki资源的存放路径
如果不进行配置wiki资源默认存放于:C:\Users\[your user name]\jspwiki-files内。
存放格式为txt，易于删除、备份和修改。
扩展阅读：使用OpenUPM发布自己的Unity项目 https://zhuanlan.zhihu.com/p/146565975
