Skip to content

Latest commit

 

History

History
106 lines (82 loc) · 4.28 KB

README.md

File metadata and controls

106 lines (82 loc) · 4.28 KB
Raw

Ticwear Developer SDK

为了方便第三方开发者迅速使用SDK来开发Ticwear应用，我们提供了以下联系方式来协助开发：
QQ群：114947882
微博：Ticwear
官网：http://developer.chumenwenwen.com/ 社区：http://ask.ticwear.com/

获取 Ticwear SDK

Ticwear SDK已上传至 bintray.com/ticwear/maven，可通过Gradle或者maven的方式集成到你的应用中。

Ticwear SDK主要有两个版本：

  1. mobvoi-api
    • 这个是通用版，可用于开发纯Ticwear应用，也可用于开发与Android Wear（GMS通用版）兼容的应用。
  2. mobvoi-api-gms-china
    • 这个是兼容老的Android Wear中国版（GMS 7.8.87）的特殊版本（Android Wear 2.0及更新版本请使用mobvoi-api通用版本）。

使用Gradle方式集成Ticwear SDK的方法如下：

  1. 引用Ticwear SDK的maven库

    allprojects {
    repositories {
        jcenter()
        maven {
            url 'https://dl.bintray.com/ticwear/maven'
        }
    }
}

  2. 使用Ticwear SDK

    dependencies {
    compile "com.ticwear:mobvoi-api:1.1.1"
}

    或者

    dependencies {
    compile "com.ticwear:mobvoi-api-gms-china:1.0.3"
}

对于使用Eclipse的开发人员，可以从 bintray.com/ticwear/maven 上下载JAR包使用。

非Android Wear开发者

我们建议您采用如下步骤

Android Wear开发者

Android Wear应用目前分为国际版和中国版，中国版的应用需要使用裁剪版的SDK（在文件夹android-wear-lib中可以找到）。 关于如何开发一个中国版的Android Wear应用，并将此应用移植到Ticwear平台，请参考Android Wear应用兼容文档：
http://developer.chumenwenwen.com/doc/ticwear.html#doc/1/2

如果您想让您的应用同时兼容Android Wear（国际版或中国版）和Ticwear，请采用如下步骤

  1. 添加Ticwear打包方式

  • 确保你的工程根目录的 build.gradle 文件中包含了 jcenter 代码库：

    repositories {
    jcenter()
}

  • 在工程根目录的 build.gradle 中添加对 Ticwear 打包插件的依赖：

    dependencies {
    classpath 'com.ticwear.tools.build:gradle:1.1.0'
}

  • 在 Mobile Module 的 build.gradle 中使用 Ticwear 打包插件：

    apply plugin: 'com.ticwear.application'
// or
apply plugin: 'ticwear'

  • 使用 release 方式打包

  • 更多应用打包详情，参考开发者文档中的打包应用

  1. 如果你使用了GMS通讯，需要替换成 Mobvoi Mobile Services：

  • 在项目中引入Ticwear SDK，同时保留 GMS SDK (Google Mobile Services)

  • 将代码中的GMS API替换为仅包名不同的Mobvoi Mobile Services (MMS) API，GoogleApiClient替换为MobvoiApiClient。在AndroidManifest.xml里面把com.google.android.gms.wearable.BIND_LISTENER替换为com.mobvoi.android.wearable.BIND_LISTENER

  • 在App启动时调用MobvoiApiManager.getInstance().adaptService(context)，该方法必须在任何可能的API调用操作前调用，它将会自动探测当前系统情况，选择底层是使用MMS或GMS。如果想自己决定使用哪种API，可以通过调用MobvoiApiManager.getInstance().loadService(context, group)来指定使用Ticwear或Android Wear的API，以取代上面的adaptService方法。如果这两个方法都没有被调用，API会变成仅Ticwear系统能使用的方式。

  • 在AndroidManifest.xml中注册GMS Wearable Listener Service的代理服务：

    <service android:name="com.mobvoi.android.wearable.WearableListenerServiceGoogleImpl">
  <intent-filter>
    <action android:name="com.google.android.gms.wearable.BIND_LISTENER" />
  </intent-filter>
</service>

  • 重新编译打包

  1. 更多兼容AW的详情，参考开发者文档中AW应用兼容