libgdx 启动者（个人翻译，还请指教）类和配置

本文章翻译自libGDX官方wiki,，转载请注明出处：http://blog.csdn.net/kent_todo/article/details/37942047libGDX官方网址：http://libgdx.badlogicgames.com/libGDX源码：https://github.com/libgdx/libgdx

libGDX支持的平台：

对于每一个目标平台，都必须有一个启动者类。这个类实例化了一个后期指定的Application实现，并且实例化了一个ApplicationListener，它实现了应用的逻辑。启动者类是与平台相关的，让我们来看一看怎么样来实例化和配置他们。

这篇文章假设你已经掌握了程序创建，运行和调试，并且已经导入了核心、桌面、Android和HTML5的工程到Eclipse当中。

关于libGDX程序的创建、运行和调试会在以后的博文中进行介绍，或者直接到官网查看相关文档。

Desktop(LWJGL) 桌面游戏

lwjgl简介：

打开在my-gdx-game中的Main.java类可以看到如下内容：

package com.me.mygdxgame;

import com.badlogic.gdx.backends.lwjgl.LwjglApplication;
import com.badlogic.gdx.backends.lwjgl.LwjglApplicationConfiguration;

public class Main {
public static void main(String[] args) {
LwjglApplicationConfiguration cfg = new LwjglApplicationConfiguration();
cfg.title = "my-gdx-game";
cfg.useGL30 = false;
cfg.width = 480;
cfg.height = 320;

new LwjglApplication(new MyGdxGame(), cfg);
}
}

首先，一个LwjglApplicationConfigration被实例化。这儿类指定了多种组态设定，比如初始化的屏幕分辨率，是否使用OpenGL ES 1.X或者2.0和更多。

当这个配置对象被设置之后，一个LwjglApplication被实例化。MyGdxGame()类是实现了游戏逻辑的ApplicationListener;

这样一个窗口就被创建出来了，并且ApplicationListener会被像在有关生命周期的介绍中那样被调用。

Android(安卓)

Android应用不使用main(0方法作为进入点，但是它需要一个Activity作为起始点。打开my-gdx-game-android中的MainAcitivity.java类会看到：

package com.me.mygdxgame;

import android.os.Bundle;

import com.badlogic.gdx.backends.android.AndroidApplication;
import com.badlogic.gdx.backends.android.AndroidApplicationConfiguration;

public class MainActivity extends AndroidApplication {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);

AndroidApplicationConfiguration cfg = new AndroidApplicationConfiguration();
cfg.useGL20 = false;

initialize(new MyGdxGame(), cfg);
}
}

游戏的主要的起始点是Acitivity中的onCreate()函数。注意MainAcitivity继承自AndroidApplication，而AndroidApplication又继承自Acitivity.跟桌面程序中一样，一个配置对象将被实例化（AndroidApplicationConfiguration）。只要配置完成，AndroidApplication.initalize()方法就会被调用，传递了一个ApplicationListener(即MyGdxGame)和配置参数对象。

Android应用程序能够有不同的Acitivity。但是libGDX游戏应该只有一个Acitivity。游戏的不同场景在libGDX内部实现，跟分开的Acitivity是不一样的。这样做的原因是因为创建一个新的Acitivity也意味着创建了一个县的OpenGL上下文，这是耗时的，并且意味着所有的图像资源都要被重新加载。

基于Fragement的libGDX

Android sdk提供了控制屏幕特殊部分的api,它可以再多屏幕上简单的使用。这个api就是Fragement api。libgdx也能够在一个大屏幕当中的一部分进行显示运行，前提是使用fragement。要创建一个libgdx fragement，要使用到子类:AndroidFragementApplication并且实现方法onCreateView()，比如：

public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
Plane plane = (Plane) getArguments().get(ARGS_PLANE);
return initializeForView(new MyGdxGame());
}

AndroidManifest.xml 文件

除了AndroidApplicationConfiguration之外，一个Android应用程序也通过AndroidManifest.xml文件来进行配置，在Android工程的根目录下能够找到这个文件。文件的内容大致如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.me.mygdxgame"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk android:minSdkVersion="5" android:targetSdkVersion="15" />

<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name" >
<activity
android:name=".MainActivity"
android:label="@string/app_name"
android:screenOrientation="landscape"
android:configChanges="keyboard|keyboardHidden|orientation">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>

</manifest>

目标SDK版本

指定targetSdkVersion一个大于等于3的值是很重要的，如果这个应用程序要支持运行在高于Android1.5的系统上。如果这个属性没有设置的话，更高的Android版本将会用来运行程序。绘制区域的分辨率将会比实际屏幕的分辨率低，这是很糟糕的。

屏幕方向&配置改变

除了targetSdkVersion， screenOrientation和configChanges这两个属性也应该设置。

screenOrientation属性指定了应用程序的确定的屏幕方法， 如果应用程序能够在水平和竖直方法上都能正常运行，那么这个属性就可以不设置。

configeChanges属性很重要，它总是应该有值，即被设置。如果省略了这个属性，那就意味着每次物理键盘弹出或隐藏或者屏幕方向改变的时候，应用程序都将重新启动。如果screenOrientation属性被忽略了，libgdx程序会收到ApplicationListener.resize()的调用来指出屏幕的改变。从而相应的重新布局显示的内容。

Permissions(权限)

如果应用程序要向外部存储空间（比如sd卡）中写入数据、使用网络，使用振动器或者想录音的话，下面的权限就需要被加入到AndroidManifest.xml文件中：

<uses-permission android:name="android.permission.RECORD_AUDIO"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.VIBRATE"/>

用户可能会经常对许多权限有所顾虑，所以请慎重的选择使用。

为了从锁定状态中唤醒，AndroidApplicationConfiguration.useWakeLock需要被设置成true（源码默认设置成false）;

如果游戏不需要使用加速计或者指南针的话，我们建议将AndroidApplicationConfiguration中的useAccelerometer和useCompass变量设置成false;(源码中这两个变量默认为true)

Live Wallpapers(动态壁纸)

libGDX提供了一个创建Android动态壁纸的简单的方式。一个动态壁纸的启动类叫做AndroidLiveWallpaperService,下面是一个例子：

package com.mypackage;

// imports snipped for brevity

public class LiveWallpaper extends AndroidLiveWallpaperService {
@Override
public ApplicationListener createListener () {
return new MyApplicationListener();
}

@Override
public AndroidApplicationConfiguration createConfig () {
return new AndroidApplicationConfiguration();
}

@Override
public void offsetChange (ApplicationListener listener, float xOffset, float yOffset, float xOffsetStep, float yOffsetStep,
int xPixelOffset, int yPixelOffset) {
Gdx.app.log("LiveWallpaper", "offset changed: " + xOffset + ", " + yOffset);
}
}

createListener()和createConfig()这两个方法将会在动态壁纸显示或者在Home界面创建的时候被调用。

offsetChange()方法在用户在Home界面上滑动屏幕（切换屏幕）的时候调用，它告诉你当前屏幕和中介屏幕的偏移量。这个方法会在渲染线程中被调用，所以你不用考虑去同步任何东西。

除了一个启动类，你还必须要创建一个xml文件来描述你的壁纸。我们给它起一个名字叫livewallpaper.xml。在你的Android工程中的res文件夹下面创建一个叫做xml的文件夹，然后在里面创建一个livewallpaper.xml的文件，文件中的内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<wallpaper
xmlns:android="http://schemas.android.com/apk/res/android"
android:thumbnail="@drawable/ic_launcher"
android:description="@string/description"
android:settingsActivity="com.mypackage.LivewallpaperSettings"/>

这个定义了你的动态壁纸在手机上显示的缩略图，如果你在Android系统中设置当前壁纸为你的应用程序壁纸，那么上面的description和Acitivity就会被显示出来。这个Activity就是一个标准的Activity,它可以有一些动态的效果，比如北京颜色的改变等等。你可以再SharedPreferences中储存这些设置，以后通过Gdx.app.getPreferences()来加载存储的数据。

最后，你需要向AndroidManifest.xml文件中添加东西，下面是一个包含一个简单Activity的动态壁纸的例子：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.mypackage"
android:versionCode="1"
android:versionName="1.0"
android:installLocation="preferExternal">
<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="14"/>
<uses-feature android:name="android.software.live_wallpaper" />

<application android:icon="@drawable/icon" android:label="@string/app_name">
<activity android:name=".LivewallpaperSettings"
android:label="Livewallpaper Settings"/>

<service android:name=".LiveWallpaper"
android:label="@string/app_name"
android:icon="@drawable/icon"
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/livewallpaper" />
</service>
</application>
</manifest>

上面的manifest文件定义了：

1.它使用了动态壁纸特征，关于<uses-feature>这个属性，请阅读这篇博文：http://blog.csdn.net/kent_todo/article/details/37956957

2.一个运行绑定壁纸的权限。

3.设置的acitivity。

4.动态壁纸服务，在livewallper.xml文件中指定。

目前，动态壁纸只支持Android2.1(api level 7) 以上系统。

这样构建出来的动态壁纸在触摸输入上有一定的局限性。一般情况下，只有点击和滑动事件能够被响应。如果你想响应所有的触摸事件，你可以看看AndroidApplicationConfiguration#getTouchEventsForLiveWallpaper属性，设置成true来接收所有多种的触摸事件。

Daydreams(白日梦)

Tips:Daydreams是Android自4.2的新特性，它提供了在手机处于闲置状态时更加丰富的用户交互体验，即在屏幕锁定时动态显示一些内容，并且能够与用户进行交互。

从Android4.2开始，用户可以设置Daydreams，它会在设备处于闲置或者停驻状态下显示出来。这些daydreams和屏幕保护程序很相似，能够显示像相册一类的东西。libgdx可以让你更加方便的写一个这样的daydream。

Daydream的启动类叫做AndroidDaydream,下面是一个例子：

package com.badlogic.gdx.tests.android;

import android.annotation.TargetApi;
import android.util.Log;

import com.badlogic.gdx.ApplicationListener;
import com.badlogic.gdx.backends.android.AndroidApplicationConfiguration;
import com.badlogic.gdx.backends.android.AndroidDaydream;
import com.badlogic.gdx.tests.MeshShaderTest;

@TargetApi(17)
public class Daydream extends AndroidDaydream {
@Override
public void onAttachedToWindow() {
super.onAttachedToWindow();
setInteractive(false);

AndroidApplicationConfiguration cfg = new AndroidApplicationConfiguration();
cfg.useGL20 = true;
ApplicationListener app = new MeshShaderTest();
initialize(app, cfg);
}
}

简单的继承自AndroidDaydream,重写onAttachedToWindow，设置你的配置参数和ApplicationListener并且实例化你的daydream。

除了daydream自身，你额可以提供一个设置界面（一个Acitivity）来让用户设置你的daydream。这可以使一个普通的Acitivity,或者一个libGDX的AndroidApplication。这里用一个空的Acitivity作为例子：

package com.badlogic.gdx.tests.android;

import android.app.Activity;

public class DaydreamSettings extends Activity {

}

这个设置界面必须作为metadata属性设置在Daydream service中。在res/xml目录下创建一个xml文件，然后指定：

<dream xmlns:android="http://schemas.android.com/apk/res/android"
android:settingsActivity="com.badlogic.gdx.tests.android/.DaydreamSettings" />

最后，在AndroidManifest.xml文件中添加设置界面的相关声明和一个service的描述。比如：

<service android:name=".Daydream"
android:label="@string/app_name"
android:icon="@drawable/icon"
android:exported="true">
<intent-filter>
<action android:name="android.service.dreams.DreamService" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<meta-data android:name="android.service.dream"
android:resource="@xml/daydream" />
</service>

关于IOS上的文档暂时不翻译