生成App接口介绍
实现网站封装成App或混合开发App。集成到自已网站系统内,用户自主管理应用。
接口
URL地址:https://api.appbsl.net/api/cpl/make
请求方式:POST
请求参数说明
参数名必选类型说明示例
user_keystring开放平台-个人中心-接口配置-KEY的md5值89unzUJ8i
api_namestringApp版本代号,详细说明version0
systypeint要编译的系统类型,1安卓,2苹果。1
data_pathstring配置文件的下载链接,详细说明http://xxxx.com/v1.json
identifierstring网站使用的唯一标志,建议用用户ID值,用于错误定位和数据返回1
package_namestring苹果的BundleID或安卓的包名com.appbsl.www
ios_cerstring苹果的证书下载地址(含http的完整地址),编译苹果必传项http://xxxx.com/v1.p12
ios_configurationstring对应苹果证书的描述文件,编译苹果必传项http://xxxx.com/v1.mobileconfig
ios_cer_pwdstring苹果证书的密码,编译苹果必传项dd123
ios_cer_pwdstring苹果证书的密码,编译苹果必传项dd123
and_cerstring安卓keystore文件的完整下载地址,编译安卓必传项http://xxxx.com/v1.key
and_cer_aliasstring安卓keystore文件的别名,编译安卓必传项dd123
and_cer_pwdstring安卓keystore文件的密码,编译安卓必传项dd123
and_cer_store_pwdstring安卓keystore文件的store密码,编译安卓必传项dd123
local_resources_zipstring本地资源的zip资源包路径(含http的完整地址)详细说明ttp://xxxx.com/v1.zip
site_domainstring您网站的主域名,带http或https前缀https://www.bslyun.com
shop_titlestring您网站的名称变色龙云
host_urlstringpp打包使用的首页地址(含http&https的完整地址)https://www.bslyun.com
version_countint生成的版本计数,用于升级接口的版本比对。2
versionstringapp打包使用的版本号1.0.0
updateurlstring升级地址,详见下方说明详细说明https://www.bslyun.com/up1293838
adurlstring广告地址,详见下方说明详细说明https://www.bslyun.com/ad1293838
callbackstring编译回调地址,详见下方说明详细说明https://www.bslyun.com/mkapp123
logostringapp打包使用的logo图片列表,详见下方说明详细说明eyJodHRwOlwvX...bmcifQ==
startpagestringapp打包使用的启动页图片列表,详见下方说明详细说明eyJodHRwOlwvX...bmcifQ==
inidstring开放平台在创建应用时返回的唯一识别号,详情见应用创建接口com.kjcuxe.kydeoic
ios_sub_typeint苹果的详细系统类型,1iphone,3iphone+ipad1
注:数值项必须全部提供,编译前请先创建应用。安卓与苹果是独立分开生成的,生成单独系统发起一次编译 创建应用帮助
App版本代号
名称代号说明
高级版v2test
中级版version150
初级版version50
基础版ten
免费版version0
json配置文件项
包含所有配置内容的json文件,免费版包含240+配置项,高级版包含360+配置项。配置项不配置必须有变量,值可以为空。各版本JSON配置详细
本地资源
压缩包类型:zip
本地资源包的目的是为了将部分网站资源打包进app中,以提高加载速度,减少网络请求。可以只更换JS,css,常用图片,也可以整体离线html+CSS+JS+图片。离线文件帮助
升级地址
生成的app,在打开时会首先访问提供的升级接口
发送方式:POST
参数必选说明
appidstring生成App的inid值
mainurlstringapp包内的主页地址
versionint版本号数字,对应参数中的version_count
返回数据
"code":"200",//200成功,其他失败
"datas":{
	"force":"1",    //是否强制弹出的提示框只显示确定,1仅显示确定,0显示确定取消
	"close":"1",    //点击弹出框的确定键是否强制退出app,1强制退出,0不强制退出
	"v_code":"",    //系统内当前最新的版本号,对应version
	"name":"",    //应用的名称
	"v_no":"",    //系统内当前最新的版本计数,对应version_count
	"path":"",    //如果需要升级,本字段返回升级需要的apk包地址或苹果的plist文件地址
},
"msg":""         //说明内容
广告接口
生成的app,在打开时会在升级接口之后访问广告接口
发送方式:POST
参数必选说明
appidstring生成App的inid值
返回数据
"code":"200",//200成功,其他失败
"datas":{
	"ad_url":"",    //点击广告图片需要跳转到的链接
	"ad_pic":"",    //广告图片的完整地址
	"ad_delay_time":"",    //广告的持续时间,单位秒
	"ad_name":"",    //广告的名称
},
"msg":""         //说明内容
编译回调地址
编译的过程中会在各个阶段将当前的进展数据发送至回调地址,
链接需包含您本应用的标识,以免无法识别
发送方式:POST
参数必选说明
codestring安卓:150编译中,152错误,153成功
iOS:250编译中,252错误,253成功
返回数据
res:{
	"code":"150",        //安卓150编译中,152错误,153成功//iOS250编译中,252错误,253成功
	"data":{
		"ios_sub_type":"1",        //苹果的子系统号,1iphone,3iphone+ipad
		"systype":"3",        //系统,1安卓,2iOS
		"msg":"",        //结果的消息内容
		"url":"http://***/***.apk"        //如编译成功,返回apk或ipa包的下载地址
	},
	"error_code":"0011-0013"        //详细错误代码
}
logo内容
UrlEncode编码base64的logo图片数组的内容
结构:
{
	["pic_source1"] => "pic_target1"
	["图片的获取路径"] => "要放在项目中的相对路径"
}
图片要求:
以下为所有图片要求大小,请更换到自已图片。 android:
{
	["您的原图地址"] => "/app/src/main/res/mipmap-xxhdpi/ic_launcher.png"//尺寸 144*144 px
}
iOS:
{
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/40.png",//尺寸 40*40 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/58.png",//尺寸 58*58 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/60.png",//尺寸 60*60 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/80.png",//尺寸 80*80 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/87.png",//尺寸 87*87 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/120-1.png",//尺寸 120*120 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/180.png",//尺寸 180*180 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-20.png",//尺寸 20*20 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-29.png",//尺寸 29*29 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-76.png",//尺寸 76*76 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-152.png",//尺寸 152*152 px
	["您的原图地址"] => "WebApp/Images.xcassets/AppIcon.appiconset/Icon-167.png",//尺寸 167*167 px
}
例:
android结构
{
	["http://www.appbsl.net/in.png"] => "/app/src/main/res/mipmap-xxhdpi/ic_launcher.png"//尺寸 144*144 px
}
startpage内容
UrlEncode编码base64的startpage图片数组的内容
结构:
{
	["pic_source1"] => "pic_target1"
	["图片的获取路径"] => "要放在项目中的相对路径"
}
图片要求:
android:
{
	["您的原图地址"] => "/app/src/main/res/mipmap-xxhdpi/guide.png",//尺寸 1080*1920 px
	["您的原图地址"] => "/app/src/main/res/mipmap-h642dp-port-xxhdpi/guide.png"//尺寸 1080*2160 px
}
iOS:
iphone:
{
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/640-960.png",//尺寸 640*960 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/640-1136.png",//尺寸 640*1136 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/750-1334.png",//尺寸 750*1334 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1242-2208.png",//尺寸 1242*2208 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1125-2436.png",//尺寸 1125*2436 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/828-1792.png",//尺寸 828*1792 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1242-2688.png",//尺寸 1242*2688 px
}
ipad:
{
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/768_1024.png",//尺寸 768*1024 px
	["您的原图地址"] => "WebApp/Images.xcassets/LaunchImage.launchimage/1536_2048.png",//尺寸 1536*2048 px
}
例:
android数据
{
	["http://www.appbsl.net/in.png"] => "/app/src/main/res/mipmap-xxhdpi/guide.png",//尺寸 1080*1920 px
	["http://www.appbsl.net/in2.png"] => "/app/src/main/res/mipmap-h642dp-port-xxhdpi/guide.png"//尺寸 1080*2160 px
}

如需同时编译iphone,ipad请将以上两个数组合成一个即可。