zoukankan      html  css  js  c++  java
  • 使用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文档中可进行查看,不多赘述。

    最后新建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的默认网页即为安装成功。

    将JSPWiki.war放入tomcat的webapps目录内,再次运行tomcat即可自动解压。

    再去根据webapps的文件夹名进行访问,例如:

    http://127.0.0.1:8080/JSPWiki/

    可进入JSPWiki的初始界面。

    这样就安装好了。

    3.3 配置管理员权限

    如果没有管理员权限则无法对附件、Wiki页等进行删除操作。

    安装JSPWiki后默认会生成一个管理员账号,密码随机。但是有时候也不一定会跳出这个配置页面,

    此时可通过修改xml文件来强行设置管理员。

    首先点击右上角登录,新建一个账号:

    这里以新账号test1为例,进入JSPWikiWEB-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,易于删除、备份和修改。

  • 相关阅读:
    闭包(closure)与协程共用时要注意的事情
    mysql---视图
    职责链模式
    JavaScript DOM(一)
    9.7 迭代
    [BLE--Link Layer]设备蓝牙地址
    Loopback測试软件AX1用户手冊 V3.1
    操作系统
    OpenCV特征点检測------Surf(特征点篇)
    linux 命令 xxd
  • 原文地址:https://www.cnblogs.com/hont/p/13462101.html
Copyright © 2011-2022 走看看