Difference between revisions of "Getting Started (简体中文)"

(添加 Android 的运行方法,整理原文)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
== 获得 LÖVE ==
 
== 获得 LÖVE ==
 +
从 [http://love2d.org/#download LÖVE 网站] 下载最新版本的 LÖVE,然后安装到电脑中。
  
从 [http://love2d.org/#download LÖVE 网站] 下载最新版本的 LÖVE,然后安装到电脑中。 如果使用 Windows 平台并不是必须要''安装'' LÖVE 才可使用,也可以通用下载 LÖVE 压缩包,然后解压到硬盘中任意位置的方式来使用 LÖVE 。
+
=== Windows ===
 +
如果使用 Windows 平台并不一定要''安装'' LÖVE 才能使用,也可以下载 zip 压缩包,然后解压到硬盘中任意位置即可使用。
  
使用如下命令可以查看已安装的 LÖVE 版本:
+
=== OSX ===
 +
下载官方的安装包进行安装即可。
 +
 
 +
=== Ubuntu ===
 +
Ubuntu官方源的 LÖVE 版本可能是过时的,可以通过 ppa 的方式安装最新版。
 +
<source lang="bash">
 +
    sudo add-apt-repository ppa:bartbes/love-stable
 +
    sudo apt-get update
 +
    sudo apt-get install love
 +
</source>
 +
 
 +
=== Debian ===
 +
Debian Testing 和 Sid 的 LÖVE 版本通常是较新的,然而 Stable 的版本通常较老,您可以在 Stable 通过自编译进行安装或者使用 Debian 的非稳定版本。
 +
<source lang="bash">
 +
    #Debian Testing和Sid下
 +
    sudo aptitude install love
 +
    #或sudo apt-get install love
 +
</source>
 +
 
 +
=== Fedora ===
 +
在较新的 Fedora 下,可以这样安装
 +
<source lang="bash">
 +
    sudo yum install love
 +
    #或sudo dnf install love
 +
</source>
 +
 
 +
=== Archlinux ===
 +
<source lang="bash">
 +
    sudo pacman -S love
 +
</source>
 +
 
 +
=== 查看已安装的 LÖVE 版本 ===
 +
在 Windows 的 cmd,或者 Linux/OSX 的终端里,使用如下命令可以查看已安装的 LÖVE 版本:
  
 
<code>
 
<code>
Line 9: Line 43:
 
</code>
 
</code>
  
== Making a Game ==
+
== 如果你想快速入门 ==
 +
如果你懂 lua 语言又已经安装了 LÖVE 引擎,并且你希望你能从这网站里面一点一点学,那么你可以直接到[https://love2d.org/wiki/love 这里]看各个接口函数的详细说明
 +
 
 +
== 制作游戏 ==
  
To make a minimal game, create a folder anywhere, and open up your favorite code editor. Notepad++ is a pretty good one for Windows, and it has Lua support built in. Create a new file in the folder you just created, and name it main.lua. Put the following code in the file, and save it.
+
要制作一个最简单的游戏,先在硬盘中任意位置创建一个文件夹,然后打开你喜欢的代码编辑器。 Notepad ++ Windows 平台上很好的选择,它已经内建 Lua 支持。 在刚才创建的文件夹中新建一个名为 main.lua 的文件。 将下面的代码输入或复制到 main.lua 中,保存文件。
  
 
<source lang="lua">
 
<source lang="lua">
Line 18: Line 55:
 
end
 
end
 
</source>
 
</source>
 +
 +
== 运行游戏 ==
 +
 +
LÖVE 可以通过下面两种方式载入游戏:
 +
* 通过含有 main.lua 文件的文件夹
 +
* 通过顶级目录(又称根目录)含有 main.lua 文件的 [[LÖVE Game File (简体中文)|.love 文件]]
 +
 +
对于如何创建 .love 文件,请参考 [[Game Distribution (简体中文)]].
 +
 +
以上两种方式不管哪一种,在根目录必须有一个名为 <code>main.lua</code> 的文件。这个文件在 LÖVE 启动时会被载入。如果此文件丢失, LÖVE 会不承认这个文件夹或 .love 文件是游戏, 并提示这是一个错误的游戏包。最常犯的错误是将文件夹而不是它里面的内容打包。这个错误源于一个老旧的惯例(因为在解压缩文件夹时,你不想把压缩包里的文件一古脑儿全散放在当前目录中),但在 LÖVE 中那样做却不合逻辑:你只有把游戏文件夹中的内容打包,才能得到正确的 .love 文件。
 +
 +
----
 +
=== Windows ===
 +
 +
在 Windows 平台,运行游戏最简单的方法是将包含游戏的文件夹拖到 love.exe 文件上或 love.exe 的快捷方式上。注意,拖过去的文件夹中要包含 <code>main.lua</code>文件,而不是把 <code>main.lua</code>文件拖过去。
 +
 +
也可以使用下面的命令行调用它:
 +
 +
例如:
 +
<source lang="powershell">
 +
"C:\Program Files\LOVE\love.exe" "C:\games\mygame"
 +
"C:\Program Files\LOVE\love.exe" "C:\games\packagedgame.love"
 +
</source>
 +
 +
在 Windows上, 有一个特别的选项可以把控制台附到游戏窗口。这样你就可以看到 <code>print</code> 函数的输出。
 +
 +
<source lang="powershell">
 +
"C:\Program Files\LOVE\love.exe" --console
 +
</source>
 +
 +
----
 +
=== Linux ===
 +
 +
在 Linux 平台, 可以使用如下命令行运行游戏:
 +
 +
<source lang="bash">
 +
love /home/path/to/gamedir/
 +
love /home/path/to/packagedgame.love
 +
</source>
 +
 +
如果已经安装 .deb,也可以通过在文件管理双击 .love 文件的方式运行游戏。
 +
 +
----
 +
=== Mac OSX ===
 +
 +
在 Mac OSX 平台, 文件夹或 .love 文件可以放到 Love.app 上。在 Mac OSX 的终端(命令行),可以象下面这样使用 love (假设它已经安装到 Applications 目录下):
 +
 +
<source lang="bash">open -n -a love "~/path/to/mygame"</source>
 +
 +
但是以上方法不会输出调试信息到终端窗口。想要查看调试信息,你需要用以下方式直接启动位于 love.app 文件夹中的 love 的可执行文件:
 +
 +
<source lang="bash">/Applications/love.app/Contents/MacOS/love ~/path/to/mygame</source>
 +
 +
你可以在 ~/.bash_profile 文件中为以上路径创建一个别名,方便以后在终端调用 love 。
 +
 +
运行以下命令打开 .bash_profile 文件:
 +
<source lang="bash">open -a TextEdit ~/.bash_profile</source>
 +
 +
如果提示文件不存在,你需要先运行下面的命令来创建 .bash_profile 文件。然后再执行之前的命令。
 +
<source lang="bash">touch ~/.bash_profile</source>
 +
 +
把以下内容粘贴到文件末尾:
 +
<source lang="bash">
 +
# alias to love
 +
alias love="/Applications/love.app/Contents/MacOS/love"
 +
</source>
 +
 +
现在可以像 Linux 和 Windows 命令行一样调用 love :
 +
 +
<source lang="bash">
 +
love "~/path/to/mygame"
 +
</source>
 +
 +
 +
----
 +
=== Android ===
 +
只要你从 Google Play 或者其他来源安装了 LOVE APP 之后,以下方法就可用:
 +
 +
* 方法一:移动你的游戏文件夹移动到 /sdcard/lovegame 中,其中 main.lua 的位置应该是 /sdcard/lovegame/main.lua。然后启动 APP 即可。
 +
 +
* 方法二:将你的 .love 文件传到手机上,然后用文件管理器打开它。大多数文件管理器都可以,如果不行的话请安装 [https://www.coolapk.com/apk/com.estrongs.android.pop ES 文件管理器]。如果你使用 Dropbox 的话,也可以用 Dropbox 打开。
 +
 +
== 下一步 ==
 +
* [[Tutorial:Callback_Functions (简体中文)]] 将教授 love 游戏的基本结构。
 +
* [[:Category:Tutorials (简体中文)]] 是接下来要阅读内容。
 +
 +
== 其他语言 ==
 +
{{i18n|Getting_Started}}
 +
 +
[[Category:LÖVE]]

Latest revision as of 12:21, 11 July 2019

获得 LÖVE

LÖVE 网站 下载最新版本的 LÖVE,然后安装到电脑中。

Windows

如果使用 Windows 平台并不一定要安装 LÖVE 才能使用,也可以下载 zip 压缩包,然后解压到硬盘中任意位置即可使用。

OSX

下载官方的安装包进行安装即可。

Ubuntu

Ubuntu官方源的 LÖVE 版本可能是过时的,可以通过 ppa 的方式安装最新版。

    sudo add-apt-repository ppa:bartbes/love-stable
    sudo apt-get update
    sudo apt-get install love

Debian

Debian Testing 和 Sid 的 LÖVE 版本通常是较新的,然而 Stable 的版本通常较老,您可以在 Stable 通过自编译进行安装或者使用 Debian 的非稳定版本。

    #Debian Testing和Sid下
    sudo aptitude install love
    #或sudo apt-get install love

Fedora

在较新的 Fedora 下,可以这样安装

    sudo yum install love
    #或sudo dnf install love

Archlinux

    sudo pacman -S love

查看已安装的 LÖVE 版本

在 Windows 的 cmd,或者 Linux/OSX 的终端里,使用如下命令可以查看已安装的 LÖVE 版本:

love --version

如果你想快速入门

如果你懂 lua 语言又已经安装了 LÖVE 引擎,并且你希望你能从这网站里面一点一点学,那么你可以直接到这里看各个接口函数的详细说明

制作游戏

要制作一个最简单的游戏,先在硬盘中任意位置创建一个文件夹,然后打开你喜欢的代码编辑器。 Notepad ++ 是 Windows 平台上很好的选择,它已经内建 Lua 支持。 在刚才创建的文件夹中新建一个名为 main.lua 的文件。 将下面的代码输入或复制到 main.lua 中,保存文件。

function love.draw()
    love.graphics.print("Hello World", 400, 300)
end

运行游戏

LÖVE 可以通过下面两种方式载入游戏:

  • 通过含有 main.lua 文件的文件夹
  • 通过顶级目录(又称根目录)含有 main.lua 文件的 .love 文件

对于如何创建 .love 文件,请参考 Game Distribution (简体中文).

以上两种方式不管哪一种,在根目录必须有一个名为 main.lua 的文件。这个文件在 LÖVE 启动时会被载入。如果此文件丢失, LÖVE 会不承认这个文件夹或 .love 文件是游戏, 并提示这是一个错误的游戏包。最常犯的错误是将文件夹而不是它里面的内容打包。这个错误源于一个老旧的惯例(因为在解压缩文件夹时,你不想把压缩包里的文件一古脑儿全散放在当前目录中),但在 LÖVE 中那样做却不合逻辑:你只有把游戏文件夹中的内容打包,才能得到正确的 .love 文件。


Windows

在 Windows 平台,运行游戏最简单的方法是将包含游戏的文件夹拖到 love.exe 文件上或 love.exe 的快捷方式上。注意,拖过去的文件夹中要包含 main.lua文件,而不是把 main.lua文件拖过去。

也可以使用下面的命令行调用它:

例如:

"C:\Program Files\LOVE\love.exe" "C:\games\mygame"
"C:\Program Files\LOVE\love.exe" "C:\games\packagedgame.love"

在 Windows上, 有一个特别的选项可以把控制台附到游戏窗口。这样你就可以看到 print 函数的输出。

"C:\Program Files\LOVE\love.exe" --console

Linux

在 Linux 平台, 可以使用如下命令行运行游戏:

love /home/path/to/gamedir/
love /home/path/to/packagedgame.love

如果已经安装 .deb,也可以通过在文件管理双击 .love 文件的方式运行游戏。


Mac OSX

在 Mac OSX 平台, 文件夹或 .love 文件可以放到 Love.app 上。在 Mac OSX 的终端(命令行),可以象下面这样使用 love (假设它已经安装到 Applications 目录下):

open -n -a love "~/path/to/mygame"

但是以上方法不会输出调试信息到终端窗口。想要查看调试信息,你需要用以下方式直接启动位于 love.app 文件夹中的 love 的可执行文件:

/Applications/love.app/Contents/MacOS/love ~/path/to/mygame

你可以在 ~/.bash_profile 文件中为以上路径创建一个别名,方便以后在终端调用 love 。

运行以下命令打开 .bash_profile 文件:

open -a TextEdit ~/.bash_profile

如果提示文件不存在,你需要先运行下面的命令来创建 .bash_profile 文件。然后再执行之前的命令。

touch ~/.bash_profile

把以下内容粘贴到文件末尾:

# alias to love
alias love="/Applications/love.app/Contents/MacOS/love"

现在可以像 Linux 和 Windows 命令行一样调用 love :

love "~/path/to/mygame"



Android

只要你从 Google Play 或者其他来源安装了 LOVE APP 之后,以下方法就可用:

  • 方法一:移动你的游戏文件夹移动到 /sdcard/lovegame 中,其中 main.lua 的位置应该是 /sdcard/lovegame/main.lua。然后启动 APP 即可。
  • 方法二:将你的 .love 文件传到手机上,然后用文件管理器打开它。大多数文件管理器都可以,如果不行的话请安装 ES 文件管理器。如果你使用 Dropbox 的话,也可以用 Dropbox 打开。

下一步

其他语言