GBox软件源制作教程

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列表

1.1.2新增内容

增加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": "签名测试用，点下载，然后签名，再安装，如果能正常打开，则证明签名成功"
        }
    ]
}

ai2hub / gboxsource Goto Github PK

gboxsource's Introduction

GBox软件源制作教程

软件源制作流程

1.1.2新增内容

源规范说明

gboxsource's People

Contributors

Watchers

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent