README.zh-TW.md

Game Frame X LitJson

獨立遊戲前後端一體化解決方案 · 獨立遊戲開發者的圓夢大使

文檔 · 快速開始 · QQ群: 467608841 / 233840761

English | 简体中文 | 繁體中文 | 日本語 | 한국어

項目簡介

適用於 Unity 的改進型 LitJson 庫，基於 XINCGer/LitJson4Unity 二次包裝。

該庫主要服務於 GameFrameX 作為子庫使用。

快速開始

安裝

選擇以下任一方式：

1. 編輯 Unity 專案的 Packages/manifest.json，添加 scopedRegistries 部分：

   {
     "scopedRegistries": [
       {
         "name": "GameFrameX",
         "url": "https://gameframex.upm.alianblank.uk",
         "scopes": [
           "com.gameframex"
         ]
       }
     ],
     "dependencies": {
       "com.gameframex.unity.xincger.litjson": "1.1.2"
     }
   }

   scopes 控制哪些套件透過此註冊表解析。只有以 com.gameframex 開頭的套件才會從這個註冊表取得。

2. 直接在 manifest.json 的 dependencies 節點下添加以下內容：

   {
      "com.gameframex.unity.xincger.litjson": "https://github.com/gameframex/com.gameframex.unity.xincger.litjson.git"
   }

3. 在 Unity 的 Package Manager 中使用 Git URL 的方式添加庫，地址為：https://github.com/gameframex/com.gameframex.unity.xincger.litjson.git

4. 直接下載倉庫放置到 Unity 專案的 Packages 目錄下，會自動載入識別。

編輯 Unity 專案的 Packages/manifest.json，添加 scopedRegistries 部分：

{
  "scopedRegistries": [
    {
      "name": "GameFrameX",
      "url": "https://gameframex.upm.alianblank.uk",
      "scopes": [
        "com.gameframex"
      ]
    }
  ]
}

然後在 dependencies 中添加此套件：

{
  "dependencies": {
    "com.gameframex.unity.xincger.litjson": "1.1.1"
  }
}

scopes 控制哪些套件透過此註冊表解析。只有以 com.gameframex 開頭的套件才會從這個註冊表取得。

改動功能

1. 新增 link.xml 的裁剪過濾
2. 新增 LitJsonCroppingHelper 防裁剪腳本

特性

基於原生的 LitJson 庫改造，支援以下原生版本不支援的特性：

• 支援 float 類型
• 支援 Unity 內建類型（Vector2、Vector3、Rect、AnimationCurve、Bounds、Color、Color32、Quaternion、RectOffset 等）
• 支援 JsonIgnore Attribute，對某些欄位跳過序列化
• 支援對輸出的 Json 內容格式化，更規整