《客户端使用手册》


  打包工具是 AnySDK 旅途中不可或缺的一部分,因此,如何使用打包工具也就成为了最开始也是最重要的问题,今天我们将详细的介绍下打包工具的使用方法,带领大家体验打包工具的各种神秘又好用的功能,让大家在 AnySDK 的旅途中更加顺畅。

登录界面

图片   启动打包工具之后,迎面而来的是全新的 2.0 登陆界面,在 ① 号区里填入您的账号密码(Cocos 的用户可直接使用你的帐号密码进行登陆),当然若是发现您没有帐号或者不小心忘记密码了,界面上的 ② 号区有提供快捷入口,让你更快开启 AnySDK 的旅途。

主界面

图片   登录成功之后,就来到了主界面,主要分为六个功能模块——安妮市场,打包工具,自助开发,工具宝箱,技术支持和常见问题。
  而在 ③ 号区会显示各类资讯,包括:最新的渠道公告、行业资讯以及 AnySDK 最新公告等。也许大家觉得这好像跟自己没什么关系,但当你好好留意这块区域会发现有很多息息相关的行业新闻,不想落伍的开发者们赶紧好好看看吧!除此之外点击 ④ 号区的更多信息便可跳转至 AnySDK 官网了解更多信息。

游戏选择界面

  点击主界面的打包工具按钮,就会来到我们的游戏选择界面: 图片   选择您要打包的游戏,若是还没有游戏或者需要增加新游戏可点击+号来添加游戏。

游戏添加界面

图片
  添加游戏呢,是打包的最开始,所以我们要仔细的了解下这个功能,对于打包工具来说,我们需要获得足够的游戏信息才能更好的满足您的打包需求。为了能让打包一切顺利,一定要认真的填写哟!以下是关于所需信息的说明:

  1. 游戏名称(必填字段):顾名思义,就是您的游戏名称,该名称也将会在后续打包过程中对 APK 进行改名时使用到。
  2. 网络类型(必填字段):主要分为单机或者网游。
  3. 游戏类型(必填字段):主要为游戏的类型。
  4. 游戏图标(必填字段):这边我们要求选择的游戏 ICON 大小必须为 512*512,这样我们才能在不同渠道下生成带有渠道角标的 ICON,且在不同分辨率的资源目录下放入不同大小的 ICON。
  5. Keystore 文件、Keystore 密码、Alias 名称、Alias 密码:这四个字段是关于 APK 的签名信息,在打包完成时我们需要对打出来的包进行签名,才能够正常安装(若是您后面有配置渠道签名,则打包以渠道签名为主,若是没有则以游戏签名为主,若是此处您不填写则将使用 AnySDK 自带默认签名,建议填写您的签名信息,优先级为:渠道签名>游戏签名> AnySDK 自带签名),若是你对签名仍有疑问,可点击此处了解更多签名相关。
  6. 使用 CocosPlay:CocosPlay 是帮助开发者将现有 APK 游戏快速移植为点开即玩的微端游戏的一种解决方案,若是您有使用该方案建议将其勾选上,若是没有可不选。

配置界面-游戏配置界面

图片   接下来是打包前最重要的配置环节,配置的对错决定了打出来的包是否可以一路通行,所以配置管理一定要好好了解哦!
  首先我们看下游戏管理界面,① 号区中主要是用于填写游戏相关信息,默认打包签名文件,以及母包(在只集成 AnySDK_Framework 情况下)用于接收 AnySDK 支付结果的游戏服务器地址。
  在 ② 号区中提供的 AppKey、 AppSecret、 PrivateKey 等三个参数主要用于您在集成 AnySDK_Framework 时初始化使用,也用于 AnySDK 识别是哪款游戏,同时这三个参数也是为了防止不法分子在获得母包的情况下直接使用其他帐号进行打包发布,因此请妥善保护,以防泄露。
  最后,介绍下最帅的 ③ 号区,这个地方既是游戏 ICON 的展示,同时也是 ICON 的修改地方,点击图标即可修改哦!

配置界面

渠道管理界面

图片    游戏配置完成了,接下来我们需要先设定好我们的目标(嗯,今天我准备上十家渠道!),首先,我们在 ① 号区找到我们想要的上架渠道(如百度游戏),勾选上后在 ② 号区将会显示所勾选的渠道。(p.s:若是您在此处找不到想要上的渠道,可联系 AnySDK 来进行添加,或者使用下面的添加自定义渠道功能)

添加自定义渠道

图片   为了预防真的找不到渠道或者其他需求我们还是先来了解下添加自定义渠道这个功能吧!
  添加自定义渠道主要是让用户更加灵活的来添加要上架的渠道(如 AnySDK 在公共渠道上还没有的渠道,或者您已经拥有了百度游戏这个渠道,但还想再添加个百度游戏2 的渠道用于在百度游戏的另一个分发渠道上架等情况)。
  使用方式就是,先点击 ① 号区的按钮切换至自定义渠道列表,在 ② 号区中点击添加自定义渠道,添加完的渠道将会在 ③ 处进行显示,余下操作与公共渠道相同。
  好像什么都看不懂,不过不要紧张,让我们来给您好好分析:
    渠道名(必填字段):描述渠道名称,添加完后我们会自动帮您加个[ ]来表示该渠道为自定义渠道。
    渠道编号(必填字段):可用于用户进行统计,此处我们限定输入规则为 6 位数字。
    渠道平台: Android/iOS ,我们会根据您当前所选平台模式帮您决定使用哪个平台。
    父渠道:父渠道主要用于自定义渠道与公共渠道的一个关联关系,例如:你添加一个叫百度游戏2 的渠道,那么肯定会想使用百度游戏的相关配置(如它所使用 SDK,所使用的角标,所使用的闪屏等),此时选择相应公共渠道即可。
  若是想修改自定义渠道,可在自定义渠道列表处选择渠道出现修改按钮后点击进行修改:

图片

SDK 管理界面

图片   说到 SDK 管理界面,我们这边要先讲解一个概念,就是渠道跟 SDK 是没有必然联系的,比方说你要在百度游戏这个渠道上进行上架,但是你使用的可能是 360 的 SDK ,当然此处只是为了能更灵活的配置,正常来说百度游戏死活也不会同意你这么做,但你还是可能会使用 ShareSDK,友盟等第三方辅助 SDK,这时便可通过本界面的勾选来配置需要使用的 SDK 来提升游戏的质量。

接下来介绍下如何使用:首先你需要在 ① 号区选择要配置的渠道,然后在 ② 号区选择要加入的 SDK 类型(如分享类型、统计类型等),紧接着在 ③ 号区选择需要使用的 SDK(如 ShareSDK 等),选择完后将会出现在 ④ 号区,④ 号显示的是该渠道下拥有的 SDK。

参数配置界面

图片   在确定了渠道以及所使用的 SDK 之后,我们就要开始对 SDK 进行参数配置,首先在 ① 号和 ② 号区选择你要配置的渠道及 SDK,然后进行参数配置,当然你可能会出现如上 ③ 号区的情况,这个表示本地缺少该 SDK,赶紧点击立即下载来继续我们的配置工作把! 图片   当下载完成后会在 ① 号区出现可配置的参数信息,这时候可以根据百度游戏的渠道提供给您的参数填入到指定区域,除此之外,若是想知道 SDK 的版本号可到 ① 处的右上角了解。
  除此之外您可以到 ② 号区填写渠道级别相关参数。点击 ② 号区的更多设置还可以设置渠道的签名、闪屏等。如下图: 图片   字段说明:
    渠道编号:渠道的标识符,便于开发者统计使用
    包名后缀:为满足渠道对包名后缀的需求,如百度游戏一般要求开发者包名加入 .baidu 的后缀,以防止其他渠道相互覆盖同个游戏等。
    应用名称:用于打包时渠道包里的展示名称
    SDK 插件方向:横屏、竖屏(若 SDK 参数有存在方向参数,则以 SDK 为准,对了,这个字段是否有效得建立在 SDK 是否支持方向选择)
    Log 模式:日志输出等级
    SetDebugMode:设置为是否处于调试模式(只有 SDK 支持调试,该字段才有用哟!)
    闪屏:部分渠道要求游戏启动时要先显示该渠道的闪屏。此处为开发者提供闪屏配置功能。(若是此处没有闪屏则表示该渠道不需要闪屏,或者 SDK 未下载等。)
    Keystore 文件、签名密码、Alias 、Alias 密码:渠道签名相关信息。已在添加游戏处做过解释,此处不再讲解(优先级:渠道签名>游戏签名> AnySDK 自带签名)。
    自定义参数:可根据不同渠道设置不一样的值,然后通过框架提供的 getCustomParam ()来获取自定义参数的值,方便用户为不同渠道做不同的功能需求。

自定义 Meta 功能

  打包工具除了提供自定义参数功能外,更推荐开发者使用自定义 Meta 元素的功能,点击参数配置界面的更多设置旁边的自定义 Meta 元素,出现如下配置界面:

图片

  自定义 Meta 元素的优势在于:开发者可以给参数命名,并且可以无限制的添加参数。除此之外,我们还会将所有参数写入到 AndroidManifest.xml 里,格式为:
  
  更便于开发者读取及修改自定义参数。

参数快速复制与黏贴

  接下来给大家介绍一个神奇的小功能:复制和黏贴参数功能,当您拥有数十个渠道,每个渠道都拥有一个 ShareSDK ,并且每个 ShareSDK 都选上了十多种分享时,除此之外每种分享的参数您都要重复的配置过去,这时候你会为这种工作发狂,而这个功能就是为了解决这种令人厌烦的工作,选中您要复制的渠道点击“复制参数”,切换到新的渠道,点击“黏贴参数”,就这么简单,解决这复杂又重复的工作。 图片

ICON 配置界面

图片   大部分渠道都有一个要求,就是给要在该渠道上线的游戏打上个角标,才能顺利上线。为了解决这万恶的需求,AnySDK 提供 ICON 管理功能来解决这个问题,只需要在 ① 号区选好要配置的渠道,在 ② 号区选上该渠道的专属角标,便可在打出来的包里面带上这个万恶的角标。当然为了不让这角标严重影响原有的美观度,我们还提供可以在 ③ 号区选择它的方向,以防把美女的头像给遮住了,如果还是觉得不够,自己动手调整距离吧,两个滑动条应该能满足您的需求。最后讲解下 ④ 号区批量操作角标的功能,默认情况下,只要设置好一个位置大部分角标都能放在令您满意的位置,但是还是会出现一些奇形怪异的角标,它的位置形状都很特别,您需要单独调整它,这个时候 ④ 号区的功能就发挥出很大的作用,可以单独消灭这只怪物!

打包选择界面

图片    配置工作总算做完了,接下来最期待的是看到我们之前辛苦的成果呀,开始打包吧!首先在①号区选择想要生成的渠道,然后在 ② 号区选择集成完框架的母包,就可以点击开始打包啦!这个时候你肯定想问 ③ 号区是干嘛用的?很明显,③ 号区就是用来修改打包时渠道包的应用名称,默认使用的是游戏配置界面填写的名称,若是想修改,可点击后面的编辑按钮,修改成更霸气的名称吧!

打包结果界面

图片   经过漫长的等待后,总算看到结果啦(虽然有个渠道失败了...),在 ① 号区中分别提供了关于经过处理后的渠道包的安装、卸载以及加固等功能。 说完成功的接下来要说下失败的,看到 ② 号区的红色错误提示不要慌,点击详细信息,就会有详细错误信息,若还是看不懂,亲,联系我们吧!
  最后我们说下 ③ 号区的功能:
    LogCat:设备日志查看工具(下面会详细介绍)。
    打开目录:当您测试验证通过后,会迫不及待的拿出这个包分享给你的同事,这时候点击这个按钮,就能够快速的定位到该目录,便于取出渠道包。
    完成:返回到打包选择界面。

加固界面

图片   打包完成了,接下来我们会迫不及待的想把这个包直接拿去上架,但是突然想起就这么赤裸裸的拿去上架,所有人都可以下到这个 APK,若是有些人对这个包动些手脚,拿去其他渠道上架,是不是其他渠道的收入就完全变成他们的了?的确,为了防止这种事情发生,AnySDK 推出加固功能,加固是干嘛用的?说白了就是给你的包加密,防止别人破解,修改你的包。使用方法:进入版本管理界面,首先定位您要加固的包,选择渠道包的版本号以及渠道的名称,点击加固,便会出现以上的加固类型选择界面,选完类型后,接下来就交给 AnySDK 帮你处理加固事情吧。
  P.s:目前我们只提供两种加固方式:
    梆梆安全:该加固方式由梆梆安全提供的加固方式,需要将您的渠道包上传至梆梆安全后台,经过处理后,重新下载到本地。(优点:安全性高,有保障。 缺点:需要上传,且加固时间较为漫长。)
    本地加固:该加固方式由 AnySDK 官方提供,直接在本地完成加固。(优点:无需上传,速度快。 缺点:安全性一般。)

版本管理界面

图片   当渠道越来越多时,单单管理这些渠道包就会很头疼。为了解决这类问题,AnySDK 还提供版本管理功能,能够根据版本和渠道来进行层级管理。除此之外还可以在内容介绍、更新内容等处填写该版本的游戏介绍和更新事项,在要上架前可选择导出,工具将生成一个 ZIP 包,里面包含了游戏的 APK,游戏的说明,更新内容及截图等。
  至此,打包工具的基本使用讲解完毕!后面会有新版功能推出!敬请期待!