GLWallpaperService 技术文档

1. 安装指南

安装 GLWallpaperService 库

1. 下载最新的 GLWallpaperService.jar 文件。
2. 在 Eclipse 中，创建一个新的文件夹 libs/ 在项目目录下。
3. 将 GLWallpaperService.jar 文件放入 libs/ 文件夹中。
4. 如果 Eclipse 没有自动识别到 jar 文件，请刷新项目。
5. 右键点击 Android 项目，选择“属性”。
6. 在“Java Build Path”下选择“库”标签。
7. 点击“添加 JARs...”，选择 libs/GLWallpaperService.jar，然后点击“确定”。

配置 AndroidManifest.xml

1. 在 <Application> 和 </Application> 标签之间添加以下代码：

   <service android:label="@string/service_label" android:name=".MyWallpaperService"
       android:permission="android.permission.BIND_WALLPAPER">
       <intent-filter>
           <action android:name="android.service.wallpaper.WallpaperService" />
       </intent-filter>
       <meta-data android:name="android.service.wallpaper"
           android:resource="@xml/myglwallpaper" />
   </service>
   

2. 在 <Manifest> 标签内，但在 <Application> 标签外添加以下代码：

   <uses-feature android:name="android.software.live_wallpaper" android:required="true" />
   

3. 创建一个名为 ProjectFolder/res/xml 的文件夹，并创建一个名为 myglwallpaper.xml 的文件，内容如下：

   <?xml version="1.0" encoding="utf-8"?>
   <wallpaper xmlns:android="http://schemas.android.com/apk/res/android"
       android:description="@string/description"
   />
   

4. 在 res/values/strings.xml 文件中添加以下内容：

   <string name="service_label">你的壁纸名称</string>
   <string name="description">你的壁纸描述</string>
   

2. 项目的使用说明

本项目提供了一个用于创建 OpenGL 动态壁纸的库。通过实现 GLWallpaperService.Renderer 接口和扩展 GLWallpaperService 类，用户可以创建自定义的动态壁纸。

3. 项目 API 使用文档

• GLWallpaperService.Renderer: 该接口定义了渲染动态壁纸所需的方法，包括 onDrawFrame(GL10 gl)、onSurfaceChanged(GL10 gl, int width, int height)、onSurfaceCreated(GL10 gl, EGLConfig config) 和 release()。
• GLWallpaperService: 该类扩展了 Android 的 WallpaperService 类，用于管理动态壁纸的生命周期。

4. 项目安装方式

请按照以下步骤运行项目：

1. 在 Eclipse 中创建一个新的“Android 应用程序”运行配置。
2. 将项目设置为创建的 Android 项目。
3. 点击“运行”按钮，项目将被安装到手机或模拟器上。
4. 使用 Android 动态壁纸选择器屏幕，选择你的动态壁纸。

如果成功，上述代码将显示一个绿色屏幕。恭喜你，你现在可以开始创建一个出色的 OpenGL 动态壁纸了！