[关闭]
@miniknife 2017-09-20T08:19:02.000000Z 字数 5972 阅读 11997

ASO 搜索优化插件使用手册

开发手册


Windows 平台按 Ctrl + F 打开快捷搜索

Mac 平台按 command + F 打开快捷搜索

※右侧文本列表可以找到全部手册


目录

简介

  • 产品主要功能:
    快速定位搜索商品,一键切换账号等功能。
  • 支持 iOS 8.0-10.2 系统设备。
  • 支持触动普通版2.3.9以及企业版1.3.0以上版本支持。
  • 企业版与普通版为分开授权,不能通用,普通版不能换绑到企业版,购买前要看好激活卡类型。
  • 此插件由Archer开发,触动精灵提供售后服务。
  • 如果使用过程中遇到什么问题和建议,欢迎反馈。
  • 点击添加交流反馈QQ群:536113401

使用须知

  • 使用 ASOHelper 插件请先加载 tsl 库,请在脚本开头调用,会返回一个 table, 请看完整示例
  • 触动企业版只需加载插件,会自动更新下载插件
  • 触动普通版需要手动把aso.tsl文件导入到/var/mobile/Media/TouchSprite/plugin插件目录
  • 如果是普通版tsp,把tsl文件一起打包即可,因为tsl插件如果存在不会覆盖,所以如果是tsp需要判断
  • 文中提到的目录都是手机目录

文件下载

v1.1.2 版本(更新于2017/06/21)下载:aso.tsl764.9kB

功能函数

函数:loadTSLibrary 加载插件

函数名称:加载插件
函数功能:加载 ASOHelper 插件
函数方法:
local tsld = loadTSLibrary("aso.tsl")
返回值:Table 型
返回值 类型 说明
tsld.status 整数型 加载库 1-正常,2-已加载过,0-失败
tsld.path 文本型 插件路径
tsld.granted 整数型 插件授权,已授权-1,未授权-0
tsld.endtime 整数型 插件授权到期时间,时间戳需要自己转换

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载,返回一个table
  2. --只需加载一次,重复加载会报错
  3. local info = ""
  4. for k,v in pairs(tsld) do
  5. info = info .. k ..":"..v.."\n"
  6. end
  7. dialog(info, 0)

普通版tsp用例:

  1. --如果普通版tsp可以加上该段代码
  2. function file_exists(file_name) --检测指定文件是否存在
  3. local f = io.open(file_name, "r")
  4. return f ~= nil and f:close()
  5. end
  6. if file_exists(userPath().."/plugin/aso.tsl") == false then
  7. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  8. lua_exit()
  9. end
  10. local tsld = loadTSLibrary("aso.tsl") --库加载
  11. if tsld.granted == 0 then
  12. dialog("插件未授权!", 0)
  13. return
  14. end
  15. if tsld.status == 0 then --验证判断
  16. dialog("插件加载异常", 0)
  17. return
  18. end
  19. require("ascmd") --需要加载
  20. local bkvs = ASOVersions()
  21. if bkvs ~= "1.0.9.3" then --自己上传的文件版本号
  22. delFile(userPath().."/plugin/aso.tsl") --删除老版本
  23. end
  24. --以上代码请在脚本开头先调用验证加载,只需加载一次

注意事项

  • 使用该插件需要先调用该函数
  • 请先判断插件已经授权并且正常加载
  • 运行过程中只需加载一次,多次加载会导致出错

函数:appstoreLogin 账号登陆

函数名称:账号登陆
函数功能:账号登陆
函数方法:
appstoreLogin(name,pwd,type)
参数 类型 说明
name 文本型 账号
pwd 文本型 密码
type 整数型 登陆类型,默认自动登陆,为1时为弹窗登陆

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. appstoreLogin("zhanghao","mima")

注意事项

  • 需要打开AppStore才能调用

函数:appstoreLogout 账号退出登陆

函数名称:账号退出登陆
函数功能:账号退出登陆
函数方法:
appstoreLogout(type)
参数 类型 说明
type 整数型 退出类型,与登陆类型对应

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. appstoreLogout()

函数:appstoreStatus 查询账号登陆状态

函数名称:查询账号登陆状态
函数功能:查询账号登陆状态
函数方法:
local status = appstoreStatus(type)
返回值 类型 说明
type 整数型 查询类型,与登陆类型对应
返回值 类型 说明
status 整数型 已登录返回1,其他返回0

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. local status = appstoreStatus()
  21. dialog(status, 0)

函数:AppstoreTopApp 应用置顶

函数名称:应用置顶搜索
函数功能:将需要搜索的应用置顶,秒完成
函数方法:
AppstoreTopApp(appid)
参数 类型 说明
appid 文本型 程序的ID

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. --比如AppStore商店搜索任何关键字前先调用该函数
  21. AppstoreTopApp("392901672")

注意事项

  • 该函数需要打开AppStore后搜索关键字之前调用
  • 如果不想置顶应用,传空参数或者重新打开AppStore即可取消
  • 与appstoreSearchApp函数功能类似,但appstoreSearchApp函数效率低,优先用AppstoreTopApp函数即可

函数:appstoreSearchApp 应用查询定位

函数名称:应用查询定位
函数功能:应用查询定位
函数方法:
local rest = appstoreSearchApp(appid,max,timeout)
参数 类型 说明
appid 文本型 程序的ID
max 整数型 查询最大条数范围
timeout 整数型 超时时间,秒
返回值 类型 说明
rest 整数型 成功找到返回第几个应用,未找到返回-1

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. --比如AppStore商店搜索 qq 出结果后调用
  21. local rest = appstoreSearchApp("392901672",1000,180)
  22. dialog(rest, 0)

注意事项

  • 该函数需要打开AppStore搜索后才调用
  • 未找到返回错误结果返回-1
  • 该函数没函数AppstoreTopApp效率高,可优先使用函数AppstoreTopApp

函数:ASOVersions 获取版本号

函数名称:获取版本号
函数功能:获取插件版本号
函数方法:
local bkvs = ASOVersions()
返回值 类型 说明
bkvs 文本型 插件版本号,如:1.0.5

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. local bkvs = ASOVersions()
  21. dialog(bkvs, 0)

函数:appstoreClear 清理应用商店缓存

函数名称:获取版本号
函数功能:获取插件版本号
函数方法:
appstoreClear()

函数用例:

  1. function file_exists(file_name) --检测指定文件是否存在
  2. local f = io.open(file_name, "r")
  3. return f ~= nil and f:close()
  4. end
  5. if file_exists(userPath().."/plugin/aso.tsl") == false then
  6. dialog("库文件不存在,请手动导入aso.tsl文件到"..userPath().."/plugin目录下", 0)
  7. lua_exit()
  8. end
  9. local tsld = loadTSLibrary("aso.tsl") --库加载
  10. if tsld.granted == 0 then
  11. dialog("插件未授权!", 0)
  12. return
  13. end
  14. if tsld.status == 0 then --验证判断
  15. dialog("插件加载异常", 0)
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. appstoreClear()

注意事项

  • 该函数调用后设备会自动重启,所以不建议频繁调用
  • 不要放到脚本循环里,请在有需要时手动调用
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注