Libgdx learning path 01: libgdx introduction and running tutorial

One 、 Introduce libGDX

libGDX It's an open source, cross platform 2D/3D Game development framework for , It consists of Java/C/C++ Written in language . compatible （Windows/Linux/Android/IOS/HTML） Wait for multiple platforms .

Official website ：libGDXlibGDX is a cross-platform Java game development framework based on OpenGL (ES) that works on Windows, Linux, macOS, Android, your browser and iOS.https://libgdx.com/

Code is hosted in GitHub：libGDX_GitHubDesktop/Android/HTML5/iOS Java game development framework - GitHub - libgdx/libgdx: Desktop/Android/HTML5/iOS Java game development frameworkhttps://github.com/libgdx/libgdx

  framework

The main composition is shown in the figure below （ From Baidu Encyclopedia , Invasion and deletion ）

Libgdx from audio、files、graphics、math、physics、scenes、utils These main modules consist of , They correspond to Libgdx Medium Audio operation , File read ,2D/3D Rendering ,Libgdx Drawing related operations ,Box2D encapsulation ,2D/3D Game components , as well as Libgdx Built in tool class .

It provides a clear framework for designing games

The game design architecture is shown in the figure below

Two 、 Generate and import a libGDX project

1、 preparation

• IDE（Android Studio、Eclipse、IDEA All right ） I used Eclipse and Android Studio.
• JDK11+  Although the official say is 8 That's all , But the latest version of project generation requires JDK11 above .
• Maven Prepare the domestic image address
• Android SDK build tools 31.0.0.0+  * Not necessary Only when Android is needed for the project
• RoboVM OSS* Not necessary Project needs IOS You need to prepare when you end

After finishing the preparatory work , We can start the next step , Prepare to build the project

2、 Generating project

The official has prepared a project generation tool  gdx-setup

gdx-setuphttps://libgdx-nightlies.s3.eu-central-1.amazonaws.com/libgdx-runnables/gdx-setup.jar After downloading, you can directly double-click to open , If it can't be opened, you can also input the command to open

java -jar gdx-setup.jar

Open it as shown in the figure

  From top to bottom is

• Project name Project name
• Package name Project package name
• Game class Game main class name
• Output folder Generate project storage address
• Android SDK * Not necessary If I check that Android You need to specify SDK

recommend ： Click on Advanced stay Maven Mirror URL Enter the Alibaba cloud image address in

Click on save After saving the settings, click Generate Start building project

The first time you build a project, it will be very slow , Wait a few minutes .

After completion, a success prompt as shown in the following figure will appear , Congratulations on your successful project generation ！

 3、 Import the project

Preparation before import

Use gdx-setup Project generation , Will automatically download gradle To C:\Users\{ Current computer user name }\.gradle\wrapper\dists

Then configure gradle To system variables and so on , You can refer to

stay Eclipse Import

First, let eclipse Support gradle, stay Window -> Preferences -> Gradle -> Choose Gradle wrapper It can be applied

And then in eclipse in , Click on the top left corner File -> import -> Gradle -> Existing Gradle Project -> Select the folder where the project is located -> Gradle wrapper -> finish You can start importing the project

After successful import, the project structure is shown in the figure

  

stay Android studio Import

open AS after , Click on Open, Open  build.gradle  file

Then wait for the project to be imported , After successful import, the project structure is shown in the figure

3、 ... and 、 Run the project

1、 Desktop Project （desktop）

 Eclipse

Right click the item name -desktop modular -> Run As -> Run Configurations ->Java Application -> Create a new form

-> stay ② Enter the project name in stay ③ Enter the main class of the project desktop module ->Run

 

  After success, as shown in the figure below

2、 Andrews end project （Android）

Android Studio

Select virtual machine device or real machine , Click on the run , It will be automatically packaged and generated APK And install and run

3、 Web side project （HTML） 

Find the project folder under the build project path

Open in this folder DOS window   or   stay DOS Window into the folder （ Tips ： Press and hold... In the folder shift Right click here to open Powershell window ）

File path Reference resources （D:\Project\libgdx\gdx-demo2）, Enter the following code on the command line

./gradlew html:superDev

Began to run  

  After running successfully, it will display

  Open the url http://localhost:8080/index.html You can see the game

4、iOS End operation

See this article for specific operations

hold libGDX Project deployment to iOS_TDSSS The blog of -CSDN Blog Simple summary libGDX Deploy to iOS Experience https://blog.csdn.net/TDSSS/article/details/125682515

5、 Command line run （ Expand ）

In addition to using tools , In fact, all terminals can be run from the command line

Desktop：

./gradlew desktop:run

Android：

./gradlew android:installDebug android:run

notes ： When running with Android command ,ANDROID_HOME Need to point to a valid Android SDK 

iOS：

./gradlew ios:launchIPhoneSimulator

 HTML：

./gradlew html:superDev

  Four 、 A simple little game （ Expand ） * Not necessary

According to the guidance of official documents , The official will teach you how to play a little game of catching raindrops with a bucket , The address is as follows

A simple little game （ The bucket catches raindrops ）Before diving into the APIs provided by libGDX, let’s create a very simple “game”, that touches each module provided by the framework, to get a feeling for things. We’ll introduce...https://libgdx.com/wiki/start/a-simple-game besides , Another document has benefited me a lot , A blogger guides how to use libGDX Make a small game prototype of playing bricks , Very interesting , The address is as follows

LibGDX beginner tutorial（ Brick making ）https://colourtann.github.io/HelloLibgdx/index.html