เตรียมไฟล์แอป

เตรียมไฟล์แอป¶

ในการแจกจ่ายแอปด้วย Crossplay Launcher คุณต้องเตรียมไฟล์ที่จำเป็นสำหรับการรันแอปบนพีซี ซึ่งรวมถึงไอคอนแอป ไฟล์การดำเนินการของแอป ไฟล์การกำหนดค่าของแอป และอื่นๆ ตามที่แสดงในตัวอย่างด้านล่าง:

ROOT_FOLDER
│  meta.json
└─ APP_FOLDER
    │  app.ico
    │  app.exe
    │  app.ini
    │  ...
    └─ resources
    └─ data
    └─ packages
    └─ ...

ROOT_FOLDER¶

ROOT_FOLDER คือไดเรกทอรีระดับสูงสุดที่มีข้อมูลทั้งหมดที่จำเป็นในการแจกจ่ายแอปด้วย Crossplay Launcher. ROOT_FOLDER ควรมี APP_FOLDER และ meta.json. ชื่อโฟลเดอร์ ROOT_FOLDER สามารถกำหนดโดยนักพัฒนาแอป. หลังจากกำหนดชื่อแล้ว ควรป้อนใน Hive Console ภายใต้ Crossplay Launcher > App Management > Download Setting > Game Installation Option > Folder Name.

APP_FOLDER¶

APP_FOLDER คือโฟลเดอร์ที่มีไฟล์ที่จำเป็นสำหรับการทำงานของแอป เตรียมและวางไฟล์การทำงานของแอป ไฟล์ไอคอน แหล่งข้อมูล ข้อมูล และไฟล์ที่จำเป็นอื่น ๆ ในโฟลเดอร์นี้ ชื่อโฟลเดอร์ APP_FOLDER สามารถกำหนดโดยนักพัฒนาแอป อย่างไรก็ตาม ชื่อโฟลเดอร์ไม่ควรมีตัวอักษร "#" หรือ ";" และไม่ควรมีโฟลเดอร์ย่อยที่ว่างเปล่า

META.JSON¶

ใน meta.json จะมีเส้นทางสัมพัทธ์ของไฟล์การดำเนินการของแอป (app.exe), ไฟล์ไอคอน (app.ico) ซึ่งตั้งอยู่ใน APP_FOLDER และเส้นทางหรือเส้นทางในรีจิสทรีที่จะถูกลบพร้อมกับแอปเมื่อทำการถอนการติดตั้ง เส้นทางสัมพัทธ์ของไฟล์การดำเนินการของแอปและไฟล์ไอคอนจะสัมพันธ์กับตำแหน่งของไฟล์ meta.json ไฟล์ meta.json จะต้องอยู่ ในตำแหน่งเดียวกับ APP_FOLDER.

เขียนไฟล์ meta.json ตามรูปแบบตัวอย่างด้านล่าง

{
    "launch": "APP_FOLDER/app.exe",
    "icon": "APP_FOLDER/app.ico",
    "delete": [
        {
        "type": "CSIDL",
        "path": "0x1c/myGameLocalRes"
        },
        {
        "type": "general",
        "path": "C:/myGameGlobalRes"
        },
        {
        "type": "registrykey",
        "root": "0x80000001",
        "path": "SOFTWAREMyGame"
        }
    ]
}

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
launch	เส้นทางสัมพัทธ์ของไฟล์การดำเนินการแอป (เช่น app.exe) ที่ใช้เมื่อเรียกใช้แอปด้วย Crossplay Launcher	string	Y
icon	เส้นทางสัมพัทธ์ของไฟล์ไอคอนแอป (เช่น app.ico) ที่จำเป็นในการสร้างไฟล์ทางลัดบนเดสก์ท็อป PC และเมนูเริ่มเมื่อทำการติดตั้งแอปด้วย Crossplay Launcher เพื่อสร้างไฟล์ทางลัดใน Crossplay Launcher ไฟล์ไอคอนต้องมีอยู่ ไฟล์รูปแบบควรเป็น `ico` และเพื่อความเข้ากันได้กับความละเอียดของหน้าจอ ควรบรรจุเป็นไฟล์ `ico` ไฟล์เดียวที่มีภาพทั้งหมด 6 รูปภาพที่มีความละเอียดต่างกัน. 16X16 32X32 48X48 64X64 128X128 256X256	string	Y
delete	ในระหว่างการเรียกใช้แอป แอปอาจสร้างข้อมูลในโฟลเดอร์อื่นนอกเหนือจากโฟลเดอร์การติดตั้งแอป ไฟล์หรือรายการในรีจิสทรีที่ตั้งอยู่ที่อื่นนอกเหนือจากโฟลเดอร์การติดตั้งแอปจะต้องถูกลบเมื่อถอนการติดตั้งแอป ฟิลด์นี้มีข้อมูลเกี่ยวกับไฟล์หรือรีจิสทรีเหล่านั้น ซึ่งเป็นอาร์เรย์ของข้อมูลโฟลเดอร์และข้อมูลรีจิสทรีที่จะถูกลบ. `type`: ประเภทของข้อมูลที่จะถูกลบเมื่อถอนการติดตั้งแอป (โฟลเดอร์หรือรีจิสทรี) `root`: ค่าที่จะต้องป้อนเฉพาะเมื่อ `type` เป็นรีจิสทรี ซึ่งระบุรากของรีจิสทรี * `path`: เส้นทางโฟลเดอร์หรือรีจิสทรีที่จะถูกลบเมื่อถอนการติดตั้งแอป	array	N

ต่อไปนี้เป็นคู่มือสำหรับอาร์เรย์ delete :

ชื่อฟิลด์	คำอธิบาย	ประเภท	จำเป็น
type	ประเภทของข้อมูลที่จะถูกลบ. `CSIDL`: เมื่อ ไฟล์ที่จะถูกลบ ตั้งอยู่ในโฟลเดอร์พิเศษที่ใช้โดย Windows OS เช่น ProgramFiles หรือ AppData `general`: เมื่อไฟล์ที่จะถูกลบตั้งอยู่ในเส้นทางปกติ * `registrykey`: เมื่อ ไฟล์ ที่จะถูกลบเป็นไฟล์รีจิสทรี	string	Y
root	สตริงในรูปแบบฐานสิบหกที่แสดงถึง Root ของรีจิสทรี จะต้องกรอกเฉพาะเมื่อ `type` เป็น `registrykey` ด้านล่างนี้เป็นตัวอย่างของ Roots ของรีจิสทรีและค่าฐานสิบหกที่สอดคล้องกัน. Root: HKEY_CLASSES_ROOT, Value: `0x80000000` Root: HKEY_CURRENT_USER, Value: `0x80000001` * Root: HKEY_LOCAL_MACHINE, Value: `0x80000002` * Root: HKEY_USERS, Value: `0x80000003` * Root: HKEY_CURRENT_CONFIG, Value: `0x80000005`	string	N
path	เส้นทางที่ข้อมูล `type` ตั้งอยู่.* เมื่อ `type` เป็น `CSIDL`: เขียนในรูปแบบ CSIDL(16 หลักฐานสิบหก)/{เส้นทางที่เหลือ} * เมื่อ `type` เป็น `general`: เขียนเป็นเส้นทางสัมบูรณ์ * เมื่อ `type` เป็น `registrykey`: ในเส้นทางรีจิสทรีทั้งหมด จะเขียนเฉพาะต้นไม้ย่อยและคีย์เท่านั้น โดยไม่รวม Root	string	Y

Note

Refer to this for CSIDL hexadecimal values.

ต่อไปนี้คือตัวอย่างของการกำหนดค่า meta.json เมื่อไฟล์แอปเกมบางไฟล์ถูกเตรียดไว้ตามที่แสดงด้านล่าง:

ข้อมูล	ประเภท	ตำแหน่งข้อมูล	หมายเหตุ
game.exe	ไฟล์การดำเนินการเกม	ROOT_FOLDER/game	ROOT_FOLDER และ game เป็นไดเรกทอรีที่ระบุโดยบริษัทเกม
icon.ico	ไฟล์ไอคอน	ROOT_FOLDER/game	ROOT_FOLDER และ game เป็นไดเรกทอรีที่ระบุโดยบริษัทเกม
MyGame	รีจิสทรี	HKEY_CURRENT_USERSOFTWARESOFTWAREMyGame	ข้อมูลรีจิสทรีที่สร้างขึ้นระหว่างการดำเนินการเกม ข้อมูลที่จะถูกลบพร้อมกับเกมเมื่อถอนการติดตั้ง
myGameGlobalRes	โฟลเดอร์ (เส้นทางทั่วไป)	C:/myGameGlobalRes	ข้อมูลที่สร้างขึ้นระหว่างการดำเนินการเกม โฟลเดอร์ที่มีไฟล์ที่จะถูกลบพร้อมกับเกมเมื่อถอนการติดตั้ง
myGameLocalRes	โฟลเดอร์ (เส้นทางพิเศษ)	C:/Users/[username]/AppData/Local/myGameLocalRes	ข้อมูลที่สร้างขึ้นระหว่างการดำเนินการเกม โฟลเดอร์ที่มีไฟล์ที่จะถูกลบพร้อมกับเกมเมื่อถอนการติดตั้ง

ในสถานการณ์ข้างต้น ให้เขียนไฟล์ meta.json ดังนี้:

{
    "launch": "game/game.exe",
    "icon": "game/icon.ico",
    "delete": [
        {
        "type": "CSIDL",
        "path": "0x1c/myGameLocalRes"
        },
        {
        "type": "general",
        "path": "C:/myGameGlobalRes"
        },
        {
        "type": "registrykey",
        "root": "0x80000001",
        "path": "SOFTWAREMyGame"
        }
    ]
}