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

(制作游戏)
(添加 Android 的运行方法,整理原文)
 
(15 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>
 
love --version
 
love --version
 
</code>
 
</code>
 +
 +
== 如果你想快速入门 ==
 +
如果你懂 lua 语言又已经安装了 LÖVE 引擎,并且你希望你能从这网站里面一点一点学,那么你可以直接到[https://love2d.org/wiki/love 这里]看各个接口函数的详细说明
  
 
== 制作游戏 ==
 
== 制作游戏 ==
  
要制作一个最小的游戏, 先在硬盘中任意位置创建一个文件夹,然后打开你喜欢的代码编辑器。 Notepad ++ 是 Windows 平台上很好的选择,它已经内建 Lua 支持。 在刚才创建的文件夹中新建一个名为 main.lua 的文件。 将下面的代码输入或复制到 main.lua 中,保存文件。
+
要制作一个最简单的游戏,先在硬盘中任意位置创建一个文件夹,然后打开你喜欢的代码编辑器。 Notepad ++ 是 Windows 平台上很好的选择,它已经内建 Lua 支持。 在刚才创建的文件夹中新建一个名为 main.lua 的文件。 将下面的代码输入或复制到 main.lua 中,保存文件。
  
 
<source lang="lua">
 
<source lang="lua">
Line 19: Line 56:
 
</source>
 
</source>
  
== Running Games ==
+
== 运行游戏 ==
 +
 
 +
LÖVE 可以通过下面两种方式载入游戏:
 +
* 通过含有 main.lua 文件的文件夹
 +
* 通过顶级目录(又称根目录)含有 main.lua 文件的 [[LÖVE Game File (简体中文)|.love 文件]]
 +
 
 +
对于如何创建 .love 文件,请参考 [[Game Distribution (简体中文)]].
  
LÖVE can load a game in two ways:
+
以上两种方式不管哪一种,在根目录必须有一个名为 <code>main.lua</code> 的文件。这个文件在 LÖVE 启动时会被载入。如果此文件丢失, LÖVE 会不承认这个文件夹或 .love 文件是游戏, 并提示这是一个错误的游戏包。最常犯的错误是将文件夹而不是它里面的内容打包。这个错误源于一个老旧的惯例(因为在解压缩文件夹时,你不想把压缩包里的文件一古脑儿全散放在当前目录中),但在 LÖVE 中那样做却不合逻辑:你只有把游戏文件夹中的内容打包,才能得到正确的 .love 文件。
* From a folder.
 
* From a .love file (a renamed .zip-file).
 
 
In both cases, there has to be a file called <code>main.lua</code> in the root path. This file will be loaded when LÖVE starts. If this file is missing, LÖVE will not recognize the folder or .love file as game, and it will complain about a wrongly packaged game. A frequently made mistake is zipping the folder rather than its contents. This stems from very old practice (because when you unzip a folder you don't want it to splash out all over your current directory), but for LÖVE doing that doesn't make sense: you need to zip the game folder's contents '''only''', to get a correct .love.
 
  
===Windows===
+
----
 +
=== Windows ===
  
On Windows, the easiest way to run the game is to drag the folder onto love.exe, or a shortcut to love.exe. Remember to drag the folder containing <code>main.lua</code>, and not <code>main.lua</code> itself.
+
Windows 平台,运行游戏最简单的方法是将包含游戏的文件夹拖到 love.exe 文件上或 love.exe 的快捷方式上。注意,拖过去的文件夹中要包含 <code>main.lua</code>文件,而不是把 <code>main.lua</code>文件拖过去。
There's also the [[Scite]] option.
 
  
You can also call it from command line:
+
也可以使用下面的命令行调用它:
  
For instance:
+
例如:
<pre>
+
<source lang="powershell">
love C:\games\mygame
+
"C:\Program Files\LOVE\love.exe" "C:\games\mygame"
love C:\games\packagedgame.love
+
"C:\Program Files\LOVE\love.exe" "C:\games\packagedgame.love"
</pre>
+
</source>
  
On Windows, there is a special option which will attach a console to the Window. This allows you to see standard output.
+
在 Windows上, 有一个特别的选项可以把控制台附到游戏窗口。这样你就可以看到 <code>print</code> 函数的输出。
  
<code>
+
<source lang="powershell">
love --console
+
"C:\Program Files\LOVE\love.exe" --console
</code>
+
</source>
  
===Linux===
+
----
 +
=== Linux ===
  
On Linux, you can use the command line:
+
Linux 平台, 可以使用如下命令行运行游戏:
  
<pre>
+
<source lang="bash">
love /home/path/to/game
+
love /home/path/to/gamedir/
 
love /home/path/to/packagedgame.love
 
love /home/path/to/packagedgame.love
</pre>
+
</source>
 +
 
 +
如果已经安装 .deb,也可以通过在文件管理双击 .love 文件的方式运行游戏。
  
If you have installed the .deb, you can double click on .love files in your file manager as well.
+
----
 +
=== Mac OSX ===
  
===Mac OSX===
+
Mac OSX 平台, 文件夹或 .love 文件可以放到 Love.app 上。在 Mac OSX 的终端(命令行),可以象下面这样使用 love (假设它已经安装到 Applications 目录下):
  
On Mac OSX, a folder or .love file can be dropped onto the Love.app application bundle. On the Mac OSX Terminal (commandline), you can use love like this (assuming it's installed to the Applications directory):
+
<source lang="bash">open -n -a love "~/path/to/mygame"</source>
  
<code>open -a love mygame</code>
+
但是以上方法不会输出调试信息到终端窗口。想要查看调试信息,你需要用以下方式直接启动位于 love.app 文件夹中的 love 的可执行文件:
  
In some cases it may be faster to invoke the love binary inside the application bundle directly via the following:
+
<source lang="bash">/Applications/love.app/Contents/MacOS/love ~/path/to/mygame</source>
  
<code>/Applications/love.app/Contents/MacOS/love mygame</code>
+
你可以在 ~/.bash_profile 文件中为以上路径创建一个别名,方便以后在终端调用 love
  
You can setup an alias in your Terminal session to call the binary when you use <code>love</code> by adding an alias to your ~/.bash_profile (<code>open -a TextEdit ~/.bash_profile</code>):
+
运行以下命令打开 .bash_profile 文件:
 +
<source lang="bash">open -a TextEdit ~/.bash_profile</source>
  
<pre>
+
如果提示文件不存在,你需要先运行下面的命令来创建 .bash_profile 文件。然后再执行之前的命令。
 +
<source lang="bash">touch ~/.bash_profile</source>
 +
 +
把以下内容粘贴到文件末尾:
 +
<source lang="bash">
 
# alias to love
 
# alias to love
 
alias love="/Applications/love.app/Contents/MacOS/love"
 
alias love="/Applications/love.app/Contents/MacOS/love"
</pre>
+
</source>
 +
 
 +
现在可以像 Linux 和 Windows 命令行一样调用 love :
 +
 
 +
<source lang="bash">
 +
love "~/path/to/mygame"
 +
</source>
  
Now you can call love from the commandline like Linux and Windows:
 
  
<code>
+
----
love /home/path/to/game
+
=== Android ===
</code>
+
只要你从 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 打开。

下一步

其他语言