这一篇是关于maven和libgdx的。本来我准备用gradle(现已有gradle模板了)，不过暂时有点小问题，而同时libgdx官方提供了maven支持，为了快速上手还是选用maven了。

为什么要用maven

其实原因很简单…我讨厌每次新建项目结构。

从最开始接触libgdx手动建立Java项目和对应的Android项目到后面的使用setup-ui工具。

手动建立不说了…这个建立步骤甚至挡住了一些人使用libgdx的步伐。

setup-ui的确很棒，但是每次重复工作还是很麻烦，特别是需要一个完整的zip包…我本地一般不保存，所以每次都要下载。

对我而言，在用libgdx开发游戏的时候用maven有三个优点：

• 不需要去下载相关的包，不管是libgdx本身的，还是你自己使用的第三方包。

• 省去了建立初始项目结构的麻烦，一个mvn archetype:generate就搞定了。

• 各种环境不需要配置了，特别是GWT那个。

虽然很多人觉得maven老了，但是我觉得能用就行了。

不说多了，直接开始动手吧。这个系列都是以我最近在做的一个东西为例子，名字叫单词泡泡，大概是一个陪单词的（不要在意细节）。

安装libgdx-maven-archetype

刚才说到libgdx官方有支持，地址是：https://github.com/libgdx/libgdx-maven-archetype

先把它clone下来，命令

git clone git://github.com/libgdx/libgdx-maven-archetype.git

进入目录，运行

mvn install

运行效果：

安装好了就可以删除clone下来的文件了，我这里安装的是0.99版本。

然后进入你的工作目录，

mvn archetype:generate -DarchetypeGroupId=com.badlogic.gdx -DarchetypeArtifactId=gdx-archetype -DarchetypeVersion=0.9.9-SNAPSHOT

然后输入一些信息，比如groupId，artifactId啥的，最后建立完成，目录结构如下：

一些小修改

建立工作就完成了…但是很遗憾，要让它正常工作还需要修改一下小配置。

主要的问题集中在android项目上，桌面问题不大。

尝试运行命令：

mvn integration-test

这一篇主要是添加一些让游戏更人性化的东西，比如音效和加载画面，菜单等等。

这其中用到了很多资源，主要出自以下几个网站，大家有需要也可以去上面寻找。

http://www.freesound.org/

添加音效

首先是飞镖发出时候的音效，我希望是类似”bing”的一声，要短小精炼。

我使用的是http://www.freesound.org/people/BMacZero/sounds/96132/

libgdx支持的音频主要是WAV, MP3和OGG，其他的支持需要扩展支持。

libgdx中的音频有两种，一种是sound，一种是music。

一般所谓的音效使用sound，而音乐就使用music。

在DartController中添加属性

Sound bing;

在实例化方法中添加

this.bing = Gdx.audio.newSound(Gdx.files.internal("audio/bing.wav"));

在AddDart方法中添加

bing.play();

在怪兽被消灭的时候的音效我选用http://www.freesound.org/people/yottasounds/sounds/174465/

在TargetController中添加

great = Gdx.audio.newSound(Gdx.files.internal("audio/great.wav"));

最后添加一个背景音乐。我使用的是http://www.freesound.org/people/Setuniman/sounds/167453/

大小为5.7M，个人感觉有点大。

而且我需要循环播放，这就意味着末尾的这个部分的我不需要。

使用在线转换器截取并转化成ogg。

转化以后大小变成465kb了。仔细听一下，感觉很多部分是重复，所以再一次截取，只要前4秒的。

转化好以后在主类添加

backgroundMusic = Gdx.audio.newMusic(Gdx.files
.internal("audio/background.ogg"));

上一篇介绍游戏雏形的编写，这一篇将完善部分逻辑并添加更多效果。

例子代码在https://github.com/htynkn/DartsShaSha，如有需要请自行在tag中下载对应部分。

完善飞镖逻辑

现在的飞镖可以旋转可以飞行了，但是有一个问题却没有解决。

首先飞镖的速度，如果用户触摸位置很靠近左侧，那么飞镖的速度就很慢了。

其次，如果用户触摸中间位置，默认情况下飞镖应该是朝那个方向飞行，而不是飞到触摸位置就消失了。

这里的处理办法很简单，就是根据用户触摸位置，算出一个X为480的值，这样飞镖就可以飞到最右侧，同时保持相当的速度。

在createProjectile方法中添加

float r = (target.y - image.getY()) / (target.x - image.getX());//获取斜率
float detY = r *480;//获取Y的变动量
image.addAction(Actions.moveTo(480 + image.getX(), detY + image.getY(),
2f));// 设置飞镖的移动

这样基本就解决了问题。

接下来来思考飞镖的数量和相应位置。

首先飞镖的速度一定要得到限制，不然满屏幕飞镖有什么意思。这里限制飞镖的数量为5个。

在touchDown的最开始添加

if (projectiles.getChildren().size >=5) 

写这几篇文章主要是看了这个系列的文章：http://www.raywenderlich.com/352/how-to-make-a-simple-iphone-game-with-cocos2d-tutorial

这个系列主要讲述了如何使用Cocos2D编写简单的游戏。稍微读读感觉不错，所以想写个libgdx版本的。

本篇文章主要讲述基本内容的编写，包括显示人物、怪兽和飞镖。

最终效果如下图：

获取libgdx

你可以从libgdx的官网下载打包好的代码，我下载的是0.98版本。

当然，你也可以从git代码仓库获取最新的版本的，或者你习惯使用的以前版本，比如0.97。

创建项目

libgdx项目的创建可以有多种方式，我推荐使用setup-ui。方便易用还可以省去很多麻烦，特别是ADT升级以后的ClassNotFound问题。

如果是下载打包好的，那么就默认包含了gdx-setup-ui，双击就可以打开。

填写一些基本信息，然后选中你下载的0.98.zip那个压缩文件。这里我只生成一个桌面项目和Android项目。

桌面项目是方便调试，而Android项目是最后发布的。在整个开发中我始终用桌面项目调试，因为速度快，容易排错。同时周期性的在Android真机上测试。

点击生成项目，然后在Eclipse中导入。

一般导入进去以后Android项目会有一些问题，修改project.properties文件和AndroidManifest.xml配置文件。

运行效果如下：

准备工作

本例子中用到的图片如下：

用gdx-texturepacker打包成一张大图。

我整个例子都是用的是Stage模式。所以它的坐标原点在左下角，如果是一般用Spirte直接绘制，那么原点在右上角。

首先将打包好的图册复制到assets中新建的pack文件夹。

然后我们开始动工了，首先删除setup-ui生成的多余代码，整理DartsShaSha.java文件如下：

package com.cnblogs.htynkn;

import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.graphics.GL10;
import com.badlogic.gdx.scenes.scene2d.Stage;

publicclass DartsShaSha extends ApplicationAdapter {
Stage 

Box2d是一个很出名的2d物理引擎，有C++、Java等等版本。libgdx对Box2D进行了很高效的封装，极大的降低了学习和使用成本。

但是我觉得和Libgdx的UI库比起来，Box2D的使用始终比较复杂，单纯的物体降落什么的还好说，要是遇上一个特别复杂的物体，有时候就有点繁琐了。

在网上游荡时发现了physics-body-editor，绝对堪称神器。

physics-body-editor

项目主页：http://code.google.com/p/box2d-editor/

复杂对象的创建只需要用鼠标点点就行了。

工具可以到处Json格式的文件，还可以用于其他环境中。

对于Libgdx而言，该项目有一个专门的loader可供使用。

第一个小瓶子

我想了半天都没有找到一个合适的例子可以用做演示，干脆就用官方提供了那个瓶子的图片做演示。

启动编辑器，新建一个项目，导入我们要的图片。

点点鼠标把边描绘出来。

编辑器还可以进行测试，点击鼠标拖动就可以出现不同大小和速度的小球。

保存项目，你可以获得一个Json格式的文件。

将压缩包中的loader引入项目。

使用

BodyEditorLoader loader =new BodyEditorLoader(Gdx.files.internal("box2d/b.json"));

读入配置文件。然后创建一个动态对象：

BodyDef bd =new BodyDef();
bd.type = BodyType.DynamicBody;

指定密度等等

FixtureDef fd =new FixtureDef();
fd.density =1;
fd.friction =0.5f;
fd.restitution =0.3f;

libgdx的ui库可以实现一些动画效果，但是做游戏来说可能有些不足。Universal Tween Engine是一个纯java实现的动画库。

地址：http://code.google.com/p/java-universal-tween-engine/

只要能够用float表示的一切java对象它可以让它动画化，可以使用于Libgdx、Android、Swing等等。

Universal Tween Engine使用一般流程

使用Universal Tween Engine最重要的一个步骤就是实现TweenAccessor接口，这个接口定义了getValues和setValues方法。

然后Engine中注册对应的接口。然后定义一些动画效果并添加到管理器中。最后用update方法更新时间。

具体的可以参考一下Wiki：http://code.google.com/p/java-universal-tween-engine/wiki/GetStarted

在libgdx中实现简单动画

我比较喜欢使用Stage，所以下面的例子都是Stage中的。

首先实现TweenAccessor接口，我没有区分对待，比如给Image写一个，再给Button写个啥的。我直接给Actor写了一个，这样都可以用。

getValues和setValues中我定义了3中操作：只修改X值；只修改Y值；修改X和Y值。

publicstaticfinalint POSITION_X =1;
publicstaticfinalint POSITION_Y =2;
publicstaticfinalint POSITION_XY =3;

这里注意一下getValues的返回值，你修改或者操作了几个值就返回几。

代码如下：

package com.cnblogs.htynkn;

import aurelienribon.tweenengine.TweenAccessor;

import com.badlogic.gdx.scenes.scene2d.Actor;

publicclass 

前面有一篇文章介绍了用TWL进行布局，最近做其他java的东西接触到了table-layout，用着很不错，仔细看来一下文档，原来还支持libgdx。

简单试用了一下，比TWL好使多了。

TABLELAYOUT简介

TABLELAYOUT是一个轻量级的UI组件布局库。使用表格实现，有点像HTML的TABLE。

它支持libgdx, Swing, Android和TWL。支持Java API和配置文件两种方式。

同时有个配套的编辑器http://table-layout.googlecode.com/svn/wiki/jws/editor.jnlp

使用配置文件

其实最好的方法应该是使用配置文件，这样便于修改，还可以利用工具进行可视化编辑。但是libgdx对于配置文件的支持好像没有很到位（或者是版本修改等等问题）。

所以先介绍配置文件方式。配置文件的具体书写格式请参考table-layout主页。

打开编辑器，绘制一个简单的游戏界面，包含一个开始按钮和设置按钮。

配置文件如下：

debug
*spacing:12 padding:5 align:center

---
[StartButton] width:200 height:60
---
[PrefButton] width:200 height:60

那个debug是显示边框的，方便调试。空间以对应的类型为结尾，比如StartButton就是按钮。

第二行定义的是全局样式。还有很多其他样式可以定义，我个人觉得很Css盒子模型很接近。

将文件保存为main.layout。

因为TableLayout是在Stage中使用的，所以很其他的Actor的用法雷同。先添加一个table，在从table中获取TableLayout。然后定义控件，并和配置文件中的名字一一对应注册进去，最后加载配置文件。

先新建一个table并添加到stage中

Table table =new Table(skin);

好久没有更新这个系列的文章了。今天下午在群上讨论libgdx对中文的支持问题。本来Hiero做是最好的，但是LIbgdx的BitmapFont不支持多图，常用汉字3500个，是在做不到一张图上。

libgdx很早之前就有ttf的支持了，不过那个时候有点问题。经测试新版本（0.96）完全支持，特地总结出来和大家分享。

TTF字库

TTF(TrueTypeFont)是Apple公司和Microsoft公司共同推出的字体文件格式,随着windows的流行,已经变成最常用的一种字体文件表示方式，应用范围非常广。

如果是Windows操作系统，可以从Fonts文件夹中找到很多字库。也可以从网上下载。

我推荐YaHei.Consolas字库，看着很爽，反正我的eclipse就是用的这个字库。

gdx-setup-ui的使用

从libgdx下载0.96版本，可以看到文件结构如下：

强烈运行gdx-setup-ui.jar，这一个项目初始化工具。

运行界面如下：

项目名字，包名什么的按情况填写。在中间的Required配置中可以直接下载最新的稳定版本和Nightly版本。不过推荐选用本地的附件。

不用解压，直接选择zip文件，它会自动抽取需要的文件。

我使用的Eclipse，直接Import即可。

我只生成了桌面项目，一般可以把Android和Web的一起生成了。

注意一下，默认的Android项目对应的SDK是15，可以根据需要更改。有时候导入的项目会有红色感叹号，添加一个assets文件夹即可。

其中back-libgdx项目是我们的核心，一切逻辑什么的都在这里实现。back-libgdx-XXX是对应的启动而已。

libgdx使用TTF字库

准备一个TTF字库改名为font.ttf复制到assets文件夹。从压缩包中找到gdx-stb-truetype-natives.jar和gdx-stb-truetype.jar。其中gdx-stb-truetype-natives.jar添加到桌面项目，gdx-stb-truetype.jar添加到核心项目中去。如图：

现在来看看最关键的方法TrueTypeFontFactory.createBitmapFont。

我们通过它创建一个支持ttf字库的BitmapFont出来。它需要一个FileHandle和要支持的文字。当然还有一些参数，具体意义可以参考API文档。

也就是说我们需要使用TTF字库的哪些文字必须声明出来。不过问题也不到，3500常用汉字基本可以满足要求。网上还有一个常用500字，不过那个完全不够用。

我这里随便写几个作为演示。

publicstaticfinal String FONT_CHARACTERS ="世界人民爱好的美好中文支持再看看";

然后使用初始化

font = TrueTypeFontFactory.createBitmapFont(
Gdx.files.internal("font.ttf"), FONT_CHARACTERS,12.5f,7.5f,
1.0f, Gdx.graphics.getWidth(), Gdx.graphics.getHeight());

剩下的工作和使用Hiero一样的了。

publicclass App implements ApplicationListener