GBox软件源旨在构建一个ipa分享生态圈，采用json格式规范。制作软件源无需使用自己独立的服务器，可将软件源文件，和相关资源（如ipa包，图片素材等）上传至公开的公共平台，如Github等 (直接支持蓝奏云的链接，请看以下例子)
- 新建一个空文本文件，按规下文范编写软件源json文件，例子如下:
{
"version": "1.0",
"sourceName": "GBox官方软件源",
"sourceAuthor": "GBox Official",
"sourceLinkTitle": "主页",
"sourceLinkUrl": "https://gbox.run",
"sourceImage": "https://gbox.run/Public/images/source.png",
"sourceUpdateTime": "2019-11-23T11:00:00+0800",
"sourceDescription": "GBox官方软件源的描述",
"appCategories": [
"工具"
],
"appRepositories": [
{
"appType": "ENT_SIGN",
"appCateIndex": 0,
"appUpdateTime": "2019-11-23T08:00:00+0800",
"appName": "GBox",
"appVersion": "1.3.6",
"appImage": "https://gbox.run/Public/images/icon.png",
"appPackage": "https://dev.tencent.com/u/wallace_leung/p/AppHub/git/raw/master/Xero/GBox_v1.3.6_1122.ipa",
"appDescription": "App的描述"
},
{
"appType": "SELF_SIGN",
"appCateIndex": 1,
"appUpdateTime": "2019-11-23T08:00:00+0800",
"appName": "LSearch",
"appVersion": "1.0",
"appPlist": "https://www.lanzous.com/i7rn4hi",
"appDescription": "VIP测试用，点下载，然后签名，再安装，如果能正常打开，则证明VIP成功"
},
{
"appType": "LINK",
"appCateIndex": 0,
"appUpdateTime": "2019-12-27T9:30:00+0800",
"appName": "GBox官网",
"appVersion": "1.0",
"appImage": "https://dev.tencent.com/u/wallace_leung/p/AppHub/git/raw/master/Xero/icon512.png",
"appLink": "https://gbox.run",
"appDescription": "网页连接测试"
},
]
}
-
所编写的源内容必须为合法json，可以使用 json.cn 进行语法检测
-
将源内容保存以.appsrc后缀结尾的文本文件，例如gbox.appsrc，将其导入至GBox中，然后点击该文件，再点击加密，即可生成加密后的源文件(加密不是必须的，但为了保护自身劳动成果，建议都加密)，上面例子加密后的内容如下:
{
"appCategories" : [
"福利",
"工具"
],
"sourceUpdateTime" : "2019-10-10T13:00+0800",
"sourceAuthor" : "Rosi",
"sourceDescription" : "Rosi美女图片源的描述",
"version" : "1.0",
"sourceName" : "Rosi美女图片源",
"sourceImage" : "http:\/\/apiv2.prettybeauty.biz\/Public\/resources\/icon256.png",
"appRepositories" : "AwGTxWfhOXLcvwhKgAfRe6YZfcmAYxS3ZGyfRz1b1oBBTbs+X5epLINZSU8Idc9aMX5bF+zIicp99o1PvrKM6UeaRDoYzBJADisd8nQLykP\/HtfvemdPjZJJmmweoS2yEImdUwwq1b7GweSfnLvkG0G9rCBqOhg6oZGZV7wYpuSZAUXkoClKOD6DEDVapJvekp3ee0seNWwtR7LUI32Y\/wkQ+WhCL68+wzYw7Wqwh4cPkv\/NOMgZgYffDQG8tNT1PYjHHkWiF51zbn9yNtERp7cPcOUG0nUxCF9CnZOhYkmxenkuQgql1eHvglp34A77RR3hICPrp7tc05r2esIb0Z9aC66KxF6mvq2WDOmikX6qDIz6OCtD56oTcLwORR3tnEIGYXuE9dDVkBohDsxM1NhJ+DQqnkc7EiNQ6LVTI1bkbgQQJQ9iqWpA5A+S3\/1pY0+hY5H\/lSIUCAmmWZplGM1Yi5CU\/uNevfSTKecRWeu25pN+P9AfsVhIBH76DgsOGRkIzPCIv\/ZcNnW50nmffYh\/hxTNsa9obm112kB9rXtF2oiVy2ewf2jo87Y+id4cbXoFCwVppwCiDgBVnLoRamxxyF4tauPovm26yrA3GKXDBESQFHBvafBmn9P6eYEyetlzh6FY+mUND8HbnVhjuOLG\/hkdqrEuvEFCkvJv2lq5gn9x0Jj3XvHqcWAG0vabvoc2WRKNorZyOaFEagtNurWFUHMBK2aReA\/c44faV3du48EMXMib\/4u7gv6OVc7EaPKyReFEUiYTAPjYwxnF68Bc2YfR17Ux4pIgBPubShBCyqGq3Wgoj6rbOVUPXKXfMeZpg3QFp6VCy2D30TKwm679VvGL6evHPQ4Jj7qn8QVTfICYWfs9t+QPPqhfUM3eqQj8yzU3oOCyeU9BarAkBOna8yFl4undec72+P1vim6dAKhSBwcwXmsJ\/p2v9LAUDkGmTmwxLaVFVaYLzHw5xAGHIVNW4BwKEXz5sRw\/+NqVWPTQ2gHa9ehPoMm8Jv6B09dQGz7ATgAubh9NT1P97dWJxGzORBQTulLNMUsnPGCvHCLdkxs1lbZyXxhcWOMVAaBXiA3y5In1ITzycszoLiHuGmf4Ss6B+d27SAcEh57I6PMsJOzRyKbAvs6yYwQp\/pE3q3HsbHHWFzjlLhRI5VmCp88fVXrytT+VXaPcWMYXp6M5L6Sty3NS2G+4MCiH79wsbnvrUXBJc5cSKjVsmxp\/"
}
- 将其上传至可公开访问的平台上，例如GitHub，码云，Coding等，得到链接（git平台请复制raw链接），至此即可在GBox中添加该链接，稍等片刻，即可加载源中的app列表
- 增加app隐藏功能，在app对象中设置hide为true，即不会在列表中显示。
- 增加源授权功能，即可设置部分或全部app为上锁状态，需要输入密码才能解锁，以下为新增字段:
注意：开启授权源，源必须使用GBox加密，否则无效。此为一次性解锁全部上锁的app 原理：进行加密时，会分离字段lock为true的app下载链接。生成2份文件，即一份为已加密的源文件，另外一份为分离后的app真实下载地址的加密文件(此文件需要上传到服务器) AuthBackendSmapleCode文件夹内附带后台验证逻辑样例，仅供参考，可自行改进完善
{
...,
sourceProcessor: {
appsUnlock: {
authUrl: "https://xxx.com/auth.php", # 验证地址，即进行解锁时，所提交的密码将传到此链接进行权限校验
actions: [ # 解锁弹框所显示的选项，此为数组，即可显示多项
{
title: "联系作者", # 解锁弹框的选项标题
openUrl: "https://nyxz166.cn/GBox" # 解锁弹框的选项标题所对应的具体行为，点击后，会跳转到本链接
}
],
description: "此源需要联系作者授权" # 源解锁的说明
}
},
"appRepositories": [
{
"lock": true, # 需要上锁的app，添加此字段，并设置为true
"hide": true, # 非必须字段，若添加此字段，则解锁前隐藏，解锁后才显示
"appType": "SELF_SIGN",
"appCateIndex": 1,
"appUpdateTime": "2020-05-01T08:00:00+0800",
"appName": "测试包",
"appVersion": "1.0",
"appPlist": "https://www.lanzous.com/i7rn4hi",
"appDescription": "签名测试用，点下载，然后签名，再安装，如果能正常打开，则证明签名成功"
},
....
]
},
以下为完整源规范说明，已更新至v1.1.2
{
"version": "1.1.2", # 源版本号，当前为1.1.2， 只能向下兼容
"sourceName": "GBox官方源", # 源名称
"sourceAuthor": "Rosi", # 源作者
"sourceLinkTitle": "主页", # 链接标题，将于源主页的右上角显示
"sourceLinkUrl": "https://gbox.run", # 目标链接
"sourceImage": "http://xxx.com/src.png", # 源图片链接
"sourceUpdateTime": "2019-10-10T13:00:00+0800", # 源更新时间(此为UTC时间，北京为东八区，所以以+0800表示)，注意如果修改了app列表，而不更新此时间，GBox不会去解析此源的app列表
"sourceDescription": "源的简单描述",
# 授权源字段说明
sourceProcessor: {
appsUnlock: {
authUrl: "https://xxx.com/auth.php", # 验证地址，即进行解锁时，所提交的密码将传到此链接进行权限校验
actions: [ # 解锁弹框所显示的选项，此为数组，即可显示多项
{
title: "联系作者", # 解锁弹框的选项标题
openUrl: "https://nyxz166.cn/GBox" # 解锁弹框的选项标题所对应的具体行为，点击后，会跳转到本链接
}
],
description: "此源需要联系作者授权" # 源解锁的说明
}
},
# End 授权源字段说明
# 源的app分类排序，以0为起始计数，如在此排序中"福利"分类的下标为0，"工具"则为1
"appCategories": [
"福利",
"工具"
],
"appRepositories": [
{
# app类型，共有三种类型:
# SHAREING 分享类型，即直接提取app store得来的ipa，不能签名，直接安装，需要在app store登录对应的购买购买账号，即可正常使用，永不掉签
# SELF_SIGN 自签类型，需要签名后，才能正常安装，否则安装后图标为灰色不可用
# ENT_SIGN 企业签类型，如果该企业签未被注销，则可直接安装，否则需要签名后安装
# LINK 链接类型，直接打开网址，广告或宣传用途，需要填写appLink字段
"appType": "SHAREING",
"appCateIndex": 0, # app分类下标号，此处为0对应上面的分类"福利"
"appUpdateTime": "2019-10-13T08:00:00+0800", # UTC时间
"appName": "App名称",
"appVersion": "1.1", # app版本号
"appImage": "https://xxx.com/app.png", # app图标链接
"appPackage": "https://xx.com/app.ipa", # app的ipa包链接
"appDescription": "App的简短描述"
},
{
"appType": "ENT_SIGN", # 企业签
"appCateIndex": 1,
"appUpdateTime": "2019-10-03T08:00:00+0800",
"appName": "xxx",
# 此字段为app的plist配置链接，如果设置了此字段，appName，appVersion， appImage，appPackage都可省略, 但以上字段如果有设置，则优先级更高
"appPlist": "https://xxx.plist"
},
{
"appType": "LINK", # 链接类型，需要填写appLink字段
"appCateIndex": 1,
"appUpdateTime": "2019-12-27T9:30:00+0800",
"appName": "GBox官网",
"appVersion": "1.0",
"appImage": "https://dev.tencent.com/u/wallace_leung/p/AppHub/git/raw/master/Xero/icon512.png",
"appLink": "https://gbox.run", # 目录链接
"appDescription": "网页连接测试"
},
# 上锁app样例
{
"lock": true, # 需要上锁的app，添加此字段，并设置为true
"hide": true, # 非必须字段，若添加此字段，则解锁前隐藏，解锁后才显示
"appType": "SELF_SIGN",
"appCateIndex": 1,
"appUpdateTime": "2020-05-01T08:00:00+0800",
"appName": "测试包",
"appVersion": "1.0",
"appPlist": "https://www.lanzous.com/i7rn4hi",
"appDescription": "签名测试用，点下载，然后签名，再安装，如果能正常打开，则证明签名成功"
}
]
}