[关闭]
@miniknife 2018-06-11T15:06:38.000000Z 字数 6652 阅读 21445

ASO 搜索优化插件使用手册

开发手册


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

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

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


目录

简介

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

使用须知

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

文件下载

v1.1.5 版本(更新于2018-05-15)下载:https://pan.baidu.com/s/119H1dOit540kgAoxNKUKCg 密码:255f

函数:ASOVersions 获取版本号

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

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugi n目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. local bkvs = ASOVersions()
  21. dialog(bkvs, 0)

功能函数

函数:loadTSLibrary 加载插件

函数名称:加载插件
函数功能:加载 ASOHelper 插件
函数方法:
local tsld = loadTSLibrary("aso.tsl")
返回值:Table 型
返回值 类型 说明
tsld.status 整数型 加载库 1 - 正常,2 - 已加载过,0 - 失败,9 - 插件文件不存在
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用例:

lua 和企业版不要加载此段代码,会导致插件被删除

  1. --如果普通版 tsp 可以加上该段代码
  2. local tsld = loadTSLibrary("aso.tsl") --库加载
  3. if tsld.granted == 0 then
  4. dialog("插件未授权!", 0)
  5. return
  6. end
  7. if tsld.status == 0 then --验证判断
  8. dialog("插件加载异常", 0)
  9. return
  10. elseif tsld.status == 9 then --验证插件文件是否存在
  11. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  12. lua_exit()
  13. return
  14. elseif tsld.status == 2 then --验证重复加载
  15. dialog("重复加载 SAO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  16. lua_exit()
  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. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. appstoreLogin("zhanghao","mima")

注意事项

  • 需要打开 AppStore 才能调用

函数:appstoreLogout 账号退出登陆

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

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. appstoreLogout()

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

函数名称:查询账号登陆状态
函数功能:查询账号登陆状态
函数方法:
local status = appstoreStatus(type)
返回值 类型 说明
type 整数型 查询类型,与登陆类型对应
返回值 类型 说明
status 整数型 已登录返回 1,其他返回 0,若返回 - 1表示当前前台运行的程序不是应用商店,或者获取失败

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. local status = appstoreStatus()
  21. dialog(status, 0)

注意事项

  • 调用本函数需要打开 App Store
  • 打开需等待几秒钟,App Store 加载完毕呼才能返回正确结果
  • 当前页面已经在 App Store 直接调用即可

函数:AppstoreTopApp 应用置顶

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

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. --比如AppStore商店搜索任何关键字前先调用该函数
  21. AppstoreTopApp("392901672")

注意事项

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

函数:appstoreSearchApp 应用查询定位

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

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  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

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

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

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. appstoreClear()

注意事项

  • 该函数调用后设备会自动重启,所以不建议频繁调用
  • 不要放到脚本循环里,请在有需要时手动调用

函数:appstoreAuthCode 获取动态验证码

函数名称:获取动态验证码
函数功能:获取苹果商店出现的动态验证码的图片路径
函数方法:
path, result = appstoreAuthCode()
返回值 类型 说明
path 文本型 获取到的图片路径,获取失败返 回false
result 文本型 图片的 url 地址,当 path 返回 false 时可自行下载

函数用例:

  1. local tsld = loadTSLibrary("aso.tsl") --库加载
  2. if tsld.granted == 0 then
  3. dialog("插件未授权!", 0)
  4. return
  5. end
  6. if tsld.status == 0 then --验证判断
  7. dialog("插件加载异常", 0)
  8. return
  9. elseif tsld.status == 9 then --验证插件文件是否存在
  10. dialog("库文件不存在,请手动导入 aso.tsl 文件到"..userPath().."/plugin 目录下", 0)
  11. lua_exit()
  12. return
  13. elseif tsld.status == 2 then --验证重复加载
  14. dialog("重复加载 ASO 插件!会导致功能不正常,请修改脚本后重新运行", 0)
  15. lua_exit()
  16. return
  17. end
  18. require("ascmd") --需要加载
  19. --以上代码请在脚本开头先调用验证加载,只需加载一次
  20. local path, result = appstoreAuthCode()
  21. if path then
  22. dialog(path, 0)
  23. else
  24. dialog(result,0)
  25. end
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注