借助 magicwindow sdk plugin 快速集成 sdk

到目前为止， Android Studio 已经是开发原生 Android App 的主流 IDE ，它是由 Google 官方设计并基于 JetBrains 的 IntelliJ IDEA 。我们魔窗开发的 sdk 也是使用此 IDE 。

我们魔窗提供的企业级的深度链接（ Deeplink ）解决方案 mLink ，是致力于做创业者最需要、最好用、最贴心的 App 增长工具，并为创业者构建一个去中心化的高效连接时代，解决 App 有机增长、生态落地和流量共享的问题！

越来越多的 App 开始对接我们的 sdk ，有些客户有不止一个 App ，甚至有些客户有几十个、几百个 App 。如果他们要集成 sdk 的话，需要对一个个 App 来加代码，确实是不小的工作量。我们开始考虑能否帮助客户快速实现 sdk 的集成。于是，考虑从开发工具的角度来实现。因为 Android Studio 和 Xcode 都可以安装 plugin ，他们本身的架构是支持插件化的，而且他们都有丰富的第三方 plugin 。很多 plugin 的确能够帮助开发者提高工作效率，所以我们开发了基于 Android Studio 的 plugin 。

插件的安装很简单，通过搜素“ magicwindow ”就能找到我们的 plugin ，然后点 install ，重启 AndroidStudio 就能实现安装。

安装成功后，会在任务栏上出现” MagicWindow ”的字样。表示 plugin 已经安装成功了。

我们可以再验证一下，点击“ Check SDK Version ”，如果您的工程中没有集成我们的 sdk 会提示“请先下载 sdk ”。如果已经集成了我们的 sdk ，会出现一个弹框告诉您当前使用魔窗 sdk 的版本号。

这个功能的好处在于，能明确知道 sdk 的版本号。我们在帮助客户排查集成的问题时，经常会先问一下客户使用的 sdk 版本号，很多客户不知道如何去看，所以我们提供了这个贴心的功能。 言归正常，对于一个 Android App 要从头开始集成我们的 sdk ，首先可能需要看我们的集成文档。复制一堆配置代码，包括 java 的以及 xml 的，一不小心还会复制错。借助我们的” Init MagicWindow Conf ”功能，在 Application 类里可以通过图形化界面快速生成 sdk 的配置以及 AndroidManifest.xml 中的配置。

在 sdk 配置的对话框中输入 app 的渠道号和 appKey ，就会自动生成代码。这些生成的配置是集成我们 sdk 所必要的代码。

如果您想集成 mLink 的功能，也很简单。我们的 plugin 也提供了代码生成的功能。一般会在引导页的 Activity 中完成 mLink 的注册和路由，此时可以通过我们 plugin 的” Init MLink ”功能来生成这些代码。

借助 plugin 生成的代码，只能自动生成 registerWithAnnotation()这个方法。这个方法是借助 Annotation 实现 mLink 跳转，而无需写 register 逻辑。如果有特殊的跳转逻辑或者需要传递额外的参数，我们还是推荐您使用 register()方法自己来实现。

对于 mLink 相关的 Annotation ，我们也提供了快捷生成的方式，这些方式是给懒人准备的，当然我们自己用起来也觉得很方便。

此时，基本完成 sdk 的集成步骤，也差不多介绍完了我们 plugin 的全部功能。最后还剩下一个功能， App 正式发版时，一般会借助 gradle 打包，打包的时候会做一些混淆的工作。遇到过好几个客户，把我们的 sdk 也进行了混淆，从而导致无法使用 mLink 的功能。我们的 plugin 提供了“ Keep MW SDK ”的功能，它可以在 proguard 的配置中排除我们的 sdk 混淆。到此， sdk 正式集成完成了，我们没有写一行代码：）。

如果大家对我们的 plugin 感兴趣，可以去 github 上拉我们的代码（ https://github.com/magicwindow/mw-sdk-plugin ），欢迎在使用时给我们提需求，也欢迎发 pr 给我们。

最后不能忘了 Xcode 的用户，我们会等到 Swift 3 正式发布后，考虑用 Swift 3 开发一款插件给 iOS 的开发者使用。