使用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后,由於不知道庫的地址及使用說明,

大家在使用時仍不太方便,這時我們可以使用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,易於刪除、備份和修改。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2026 CODEPRJ.COM