使用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.1.4",
  "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文档中可进行查看，不多赘述。

最后新建ReadMe.md文件，供网页浏览git库时查看。

配置好之后其文件夹结构如下：

将Test1这个文件夹拿出来，把里面的内容上传至git仓库即可，注意需要包含meta文件。

上传至git仓库后，在Package Manager面板点击左上角加号，以添加git库。

点击后即可导入。

3.配置JSPWiki提供公共目录

3.1 JSPWiki简述

在资源上传内网git后，由于不知道库的地址及使用说明，

大家在使用时仍不太方便，这时我们可以使用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的默认网页即为安装成功。

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| 创建一个表格. 如果是表头则采用双竖线.

通过右上角信息选项下的附件按钮，可以插入图片或其他一些内容：

再对图片的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，易于删除和修改。