Style开发者sdk

Style支持开发者自己实现动态壁纸效果，并以组件（插件）的方式被Style所加载（热加载）。 所有的组件都会在Style的特效动态壁纸列表里展现，供用户选择使用。

同时动态壁纸合集应用也可以同样加载组件

这篇文章主要介绍：

• 组件介绍
• 如何开发组件
• 如何测试及上线
• 性能说明
• 代码混淆

什么是动态壁纸组件

壁纸引擎框架

壁纸引擎框架是运行壁纸组件的环境，里面包含了壁纸渲染的依赖代码，例如BadLogicGames的相关代码。 引擎框架会在系统中注册空白的服务，并将空白服务的生命周期方法交给代理对象。 同时引擎框架也负责创建代理对象，并调用它们的生命周期方法。 可以理解为，引擎框架就是一副空壳。壁纸的渲染都由组件完成。

壁纸组件与壁纸应用的区别

• 尽管两者都以.apk形式存在，但组件不是一个完整的应用，里面只包含关于壁纸渲染的代码和资源，不能够独立运行。

• 组件中的WallpaperService实现，必须继承自WallpaperServiceProxy、GLWallpaperServiceProxy或者GDXWallpaperServiceProxy，他们便是代理类。分别是普通壁纸渲染服务、OpenGL壁纸渲染服务、BadLogicGames游戏引擎壁纸渲染服务。他们会由 而壁纸应用中，应用的WallpaperService通常是直接继承自GLWallpaperService或者WallpaperService的，并且必须有个无参的构造方法，供系统创建对象。

• 组件依赖sdk模块，且需要实现sdk提供的IProvider接口，以返回组件中的WallpaperService代理对象。

• 组件中不需要有四大组件，只需要关注壁纸的渲染。

除了上述几点之外，其他的基本跟普通应用没有区别。因此现成的绝大多数壁纸应用转化成组件的成本、组件的开发成本都非常低廉。

工程模块说明

本工程一共包含三个模块：

• sdk
• cube-wallpaper
• component-app sdk模块是一个library模块，它是为开发者提供的组件编程规范。里面提供了IProvider接口、WallpaperServiceProxy，GLWallpaperServiceProxy和GDXWallpaperServiceProxy三个代理类，开发者需要实现三者之一以满足组件的规范。当前模块都代码都是编译时依赖的，运行时由引擎框架提供运行环境。因此此模块不能打到组件apk包中（在gradle中用provided而不是compile）。

cube-wallpaper模块是一个library模块，是壁纸的实现的一个demo，它实现GLWallpaperServiceProxy渲染出了一个立方体。该模块依赖sdk模块，但是在gradle中需要使用provided而不是compile,防止将sdk模块打到组件包里。

component-app模块是application模块。里面没有任何内容，只是简单的依赖了cube-wallpaper模块。你可以将它理解为组件的壳。因为在gradle中，application模块是不能使用provided来依赖的。因此需要多一层壳模块。

如何开发组件

仅需以下几步，即可创建你自己的组件壁纸

1、创建library模块（例如point-wallpaper,在他的build.gradle中增加sdk编译时依赖。 provided ‘com.kinglloy.style.developer:style-component-sdk:1.0.0’

dependencies {
    provided 'com.kinglloy.style.developer:style-component-sdk:1.0.0'
}

2、创建PointWallpaperService类，继承自WallpaperServiceProxy类，并创建PointWallpaperEngine类，继承自WallpaperServiceProxy.ActiveEngine类。形式如下。

public class PointWallpaperService extends WallpaperServiceProxy {
    public PointWallpaperService(Context host) {
        super(host);
    }

    @Override
    public Engine onCreateEngine() {
        return new PointWallpaperEngine();
    }

    private class PointWallpaperEngine extends ActiveEngine {
      ...
      // implement your wallpaper logic
    }

在PointWallpaperEngine引擎中实现的渲染逻辑和普通壁纸应用是一样的。

3、实现完渲染逻辑之后，接着实现IProvider接口，并通过其中的方法返回PointWallpaperService的对象。

package com.yalin.wallpaper.point;

public class ProviderImpl implements IProvider {
    @Override
    public WallpaperService provideProxy(Context host) {
        return new PointWallpaperService(host);
    }
}

4、创建壳模块component-app，里面什么都不需要，只需要在它都build.gradle文件中依赖由第1步创建的模块。

5、执行./gradlew assemble，会在component-app/build/outputs/apk/目录下产生组件的apk文件。那么一切就绪，组件开发完成。

组件包对签名没有要求，你可以使用任意密钥进行签名。

测试及上线

测试

在本工程的根目录下，为大家提供了sdk_test.apk文件。它包含Style中组件的运行环境。所以只要保证它能运行组件即可。

测试应用会从设备存储中读取配置，并加载相应组件。 因此你需要一个配置文件config.json内容如下。并将它放到/sdcard/style/目录下面。 测试应用没有动态申请权限，运行前请确保将读取外部存储权限给sdk_test.apk。

{
  "component_name": "point.apk",
  "provider_name": "com.yalin.wallpaper.point.ProviderImpl"
}

其中component_name是组件包的文件名，也需要放在/sdcard/style/目录。provider_name是上面实现的IProvider类名称，包名+类名。

将config.json和point.apk都放在/sdcard/style/目录下之后，运行测试应用。点击按钮，如果壁纸能正常加载，那么我们就成功了。

发布

要在Style和八音壁纸中发布组件，需要联系开发者[email protected]。 组件经过开发者审核之后，很快就会发布到Style和八音壁纸中。

性能说明

• Android动态壁纸的耗电量，内存占用，CPU使用等等很大程度上取决于具体的实现。因此在你的组件中，需要优化你的代码，让性能消耗变得更低。

• 当组件中出现崩溃时，会对Style和八音壁纸造成不同程度的影响。Style中变现为应用崩溃，八音壁纸中虽然应用不会崩溃，但也会影响用户体验。

• 组件首次运行需要用户下载，因此当组件包较大时，用户会消耗较长时间和较多流量。因此尽量减少组件包的大小。实践证明，组件包大小更多的取决于其中资源文件大小（图片），而组件代码量一般较少。

代码混淆

引擎框架会通过IProvider的实现名去创建其对象，并通过里面的方法获取代理对象。因此混淆时需要对IProvider实现类进行keep。混淆规则如下：

-keep class * implements com.yalin.style.engine.IProvider