Difference between revisions of "Getting Started (日本語)"

(日本語訳へのリンクに変更)
Line 1: Line 1:
== LÖVEの入手方法 ==
+
== LÖVE の入手 ==
  
最新バージョンのLÖVEは[http://love2d.org/#download こちら(英語)]から入手、インストールできます。もしWindowsをお使いで、かつインストールはしたくないという場合は、zip圧縮版のファイルを選んで下さい。好きな場所に解凍するだけでご利用いただけます。
+
最新版の LÖVE を[http://love2d.org/#download ウェブサイト]からダウンロードして、インストールしてください。 Windows において LÖVE を''インストール''したくない場合は、 .zip 形式で圧縮された実行可能形式をダウンロードしてから任意の場所へ展開してください。
  
LÖVEのバージョンはコマンドラインで下記のように引数をつける事で確認できます。
+
どのバージョンの LÖVE がインストールされているか知るには、下記のコマンドを実行してください:
<code>
+
 
 +
<source lang="bash">
 
love --version
 
love --version
</code>
+
</source>
  
 
== ゲームの作成 ==
 
== ゲームの作成 ==
  
シンプルなゲーム作成であれば、適当にフォルダーを作って、あなたのお好きなエディッターで編集するだけです。Windowsであれば、組み込みでLua言語のサポートがある「Notepad++」がお勧めですよ。
+
最小のゲームを作成するには、フォルダを任意の場所へ作成して、お好きなテキストエディタで開いてください。 [http://www.sublimetext.com/ Sublime Text] は全てのオペレーティング・システムに対して非常によいものであり、標準で Lua 言語への対応機能が組み込まれています。作成済みのフォルダへ新規ファイルの作成を行い、 <code>main.lua</code> の名前を付けて、下記のコードをファイルへ記述してから、保存してください。
新しいフォルダを作ったら、「main.lua」というファイル名でテキストファイルを作ってください。(以下訳者追補)以下にHello Worldプログラムを示します。
+
 
 
<source lang="lua">
 
<source lang="lua">
 
function love.draw()
 
function love.draw()
Line 20: Line 21:
 
== ゲームの実行 ==
 
== ゲームの実行 ==
  
LÖVEで作ったゲームをプレイする方法は二つあります。
+
LÖVE は二種類の方法でゲームを起動することができます:
* ゲームに必要なファイルを入れたフォルダから起動する
+
* main.lua ファイルのあるフォルダーから。
* .love」ファイルから起動する(上のフォルダをzip圧縮して、拡張子を変更したものです)
+
* [[LÖVE Game File (日本語)|.love ファイル]]の最上位(別名ルート)ディレクトリ内にある main.lua ファイルから。
  
どちらの場合でも、<code>main.lua</code>ファイルがフォルダのトップ階層に必要になります。このファイルはLÖVE起動時に読み込まれ、実行されます。このファイルがないと、LÖVEはフォルダないし.loveファイルをゲームとして認識できず、不適切なゲームパッケージだと文句をたれます。
+
.love ファイルの作成方法は [[Game Distribution (日本語)|Game Distribution]] を参照してください。
(訳者注:以下のブロック、いい訳し方が思いつかなかったため原文無視な意訳になります。ご注意ください)
 
zip圧縮ソフトによっては、フォルダの中にまとめてしまう物がありますのでご注意ください。——こういう挙動をするzipソフトは、解凍時にファイルをディレクトリにばらまいてしまうことを避けるための慣習のようですが——.loveは、zipファイルの階層構造の直下にmain.luaが無ければ正しいファイルとして認識されません。
 
  
 +
----
 +
=== Windows ===
  
=== Windows ===
+
[http://studio.zerobrane.com/ ZeroBrane Studio], [[Sublime Text 2 (日本語)|Sublime Text 2]], [[Notepad++ (日本語)|Notepad++]], および [[SciTE (日本語)|SciTE]] はコード・エディタからゲームを起動することができます。
 +
 
 +
それ以外に、ゲームを実行する最も簡単な方法は love.exe ファイルまたは love.exe ショートカットのいずれかへフォルダをドラッグすることです。 <code>main.lua</code> ファイルではなく、 <code>main.lua</code> のあるフォルダをドラッグするということを忘れないでください。
 +
 
 +
コマンドラインからでもゲームを起動することができます:
  
Windowsでもっとも簡単なプレイ方法は、love.exeにゲームフォルダかそのショートカットをドラッグ&ドロップすることです。ゲームフォルダにmain.luaが含まれてることをお確かめ下さい。また、main.lua自体をドラッグ&ドロップしてもだめなのでご注意。これは[[Scite]]のオプションでも同様です。
+
<source lang="powershell">
 +
"C:\Program Files\LOVE\love.exe" "C:\games\mygame"
 +
"C:\Program Files\LOVE\love.exe" "C:\games\packagedgame.love"
 +
</source>
  
コマンドラインからも同様に呼べます。以下はその一例です。(訳者注:一行目がフォルダの場合で、二行目は.zipの拡張子を修正した.loveの場合の例です)
+
単に love.exe のショートカットを作成をしてショートカットを右クリック、次に&quot;プロパティ(R)&quot;を選択してからショートカットに対する&quot;リンク先(T)&quot;にあるボックスへ希望するコマンドラインを記述してください。
<pre>
 
love C:\games\mygame
 
love C:\games\packagedgame.love
 
</pre>
 
  
コマンドラインオプションによって、標準出力の内容も得られます。
+
Windows では、<code>print</code> 呼び出しの結果を参照できるようにするために、ウィンドウにコンソールを接続する特別なコマンドライン・オプションがあります ([[conf.lua (日本語)|conf.lua]] にて <code>t.console=true</code> を設定するのと等価です):
<code>
 
love --console
 
</code>
 
  
===Linux===
+
<source lang="bash">
 +
"C:\Program Files\LOVE\love.exe" --console
 +
</source>
  
Linuxではコマンドラインから実行できます。
+
----
 +
=== Linux ===
 +
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ファイルをファイルマネージャーからダブルクリックすることでも実行できます。
+
LÖVE がシステム全体にインストールされている場合は、ファイル・マネージャーから .love ファイルをダブルクリックすることでもゲームを起動できます。
  
===Mac OSX===
+
----
 +
=== Mac OS X ===
  
Mac OSXでは、.loveファイルを「Love.app」にドラッグ&ドロップすることで実行できます。OSX付属のターミナル.appから実行したい場合、Love.appをアプリケーションフォルダに入れてから、下記のコマンドで実行できます。
+
Mac OS X では、フォルダまたは .love を love アプリケーション・バンドルへドロップすることができます。 Mac ターミナル (コマンドライン)では、このように使用できます (アプリケーションのディレクトリへインストールされていると仮定します):
  
<code>open -a love mygame</code>
+
<source lang="bash">open -n -a love "~/path/to/mygame"</source>
  
また、アプリケーションバンドル内のバイナリを直接呼ぶことでさくっと起動することもできます。
+
しかし、上記の方法ではターミナルのウィンドウへ表示されたテキストを出力しません。出力を行うには、アプリケーション・バンドル内部にある love バイナリを直接実行する必要があります:
  
<code>/Applications/love.app/Contents/MacOS/love mygame</code>
+
<source lang="bash">/Applications/love.app/Contents/MacOS/love ~/path/to/mygame</source>
  
ターミナルセッションで「~/.bash_profile 」にパスを通せば、<code>love</code>コマンドを叩くだけでも実行できるようになります。テキストエディットで編集する場合、ターミナルから<code>open -a TextEdit ~/.bash_profile</code>と入力して下記のように記述すればOKです。
+
<code>~/.bash_profile</code> へエイリアスを追加して <code>love</code> を使用する場合はターミナル・セッションにてエイリアスを設定することができます。
  
<pre>
+
ファイルを開きます
 +
<source lang="bash">open -a TextEdit ~/.bash_profile</source>
 +
 
 +
下記のコマンドを実行します
 +
<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>
 +
 
 +
----
 +
=== Android ===
 +
LOVE アプリを Google Playストアまたは別の配布元からインストールしている場合に限り、次の方法で動作します:
 +
 
 +
* 方法1 main.lua が /sdcard/lovegame/main.lua で検出されるようにするためにゲームフォルダーを  /sdcard/lovegame へ転送します。その後にアプリを実行します。
 +
 
 +
* 方法2 ゲームの .love ファイルをデバイスへ転送してからクリックします。大抵のファイル管理ソフトは LOVE アプリ使用して .love アプリを動作せます。それができない場合は ES ファイルエクスプローラーをインストールすることで動かせるようになります。 Dropbox を使用する場合は、それを .love ファイルを開くために使用することができます。
 +
 
 +
 
 +
----
 +
 
 +
=== iOS ===
 +
 
 +
iOS で LÖVE 実行するためには、まずコンパイルとインストールが必要です。この作業を行うには、 Mac OS X, [https://developer.apple.com/xcode/ Xcode 7 以降]、そしてホームページからダウンロード可能な LÖVE の iOS 版ソースコードが必要です。
 +
 
 +
* <code>include</code> および <code>libraries</code> フォルダに <code>love/platform/xcode/ios</code> フォルダが存在しない場合は、それらを[https://bitbucket.org/rude/love/downloads/love-0.10.0-ios-libraries.zip ダウンロード]してから対象フォルダへ導入してください。そのファイルには LÖVE で使用されているサードパーティーに依存するライブラリが同梱されています。
 +
 
 +
* <code>love/platform/xcode/love.xcodeproj</code> にある Xcode プロジェクトを開いて、ウィンドウの上部にあるドロップダウンメニューから <code>love-ios</code> ターゲットを選択します。
 +
 
 +
* 実行効率をもっと良くするためにビルド構成をデバッグからリリースへ変更したい場合は、同じドロップダウンの選択から "スキームの編集..." メニューを開きます。
 +
 
 +
* 右方前にあるドロップダウンから iOS シミュレーターまたは接続済みの iOS デバイスを選択して、左方の「ビルドと実行ボタン ▶︎ 」をクリックすることで コンパイル後に対象デバイスへ LÖVE がインストールされます。
 +
 
 +
iOS 版の LÖVE にはインストール済みゲームの簡素な一覧表示インタフェースが組み込まれています (配布用に .love をヒューズ化するまで使用できます)。
  
これでlinuxやwindows同様にゲームを実行できるようになります。(訳者注:.bash_profile編集後は、ターミナルを一度閉じて再度開いてください。また.bash_profileで記述ミスをやらかすとエラー出たり標準コマンドに失敗したりとか面倒なことが起こり得るのでご注意くださいね)
+
* LÖVE のインストール後に iOS シミュレータへ .love ファイルを導入するには、ウィンドウを開いている時に iOS シミュレータのウインドウへファイルをドラッグしてください。まだ実行していない場合は、 LÖVE を起動します。新たにゲームを表示するために別のゲームを現在実行中の場合は LÖVE を終了する必要がある場合があります (iOS シミュレーターのアプリの切り替えメニューを開くには Shift-Command-H を二回打鍵してください)。
  
<code>
+
* LÖVE のインストール後に iOS デバイスへ .love ファイルまたはゲームのフォルダを導入するには、 Safari でダウンロード、またはデバイス接続時にコンピューターから iTunes を経由して転送できます。 iTunes を開き、 LÖVE をインストールした iOS デバイスへ移動し、 ‘アプリ’ の項目へ移動、および下方へスクロールしてLÖVE を見つけ出してから、 LÖVE の書類項目へ .love ファイルあるいはゲームフォルダーを追加します。
love /home/path/to/game
 
</code>
 
  
== 次の一歩 ==
+
iOS 版での LÖVE ゲームのヒューズ化作成および配布方法に関しては[[Game Distribution (日本語)|Game Distribution]] を参照してください。
  
* [[Tutorial:Callback Functions (日本語)]] こちらからLÖVEゲームの基本的な構造を学べます。
+
== 次の段階 ==
* [[:Category:Tutorials]](英語) に、次に読むべき多数の情報があります。
+
* [[Tutorial:Callback_Functions (日本語)|Tutorial:Callback_Functions]] は LOVE ゲームの基本構造に関する講義です。
 +
* [[:Category:Tutorials|Category:Tutorials]] は次に理解する教本です。
  
== その他の言語 ==
+
== そのほかの言語 ==
 
{{i18n|Getting_Started}}
 
{{i18n|Getting_Started}}
  
 
[[Category:LÖVE]]
 
[[Category:LÖVE]]

Revision as of 15:00, 27 August 2016

LÖVE の入手

最新版の LÖVE をウェブサイトからダウンロードして、インストールしてください。 Windows において LÖVE をインストールしたくない場合は、 .zip 形式で圧縮された実行可能形式をダウンロードしてから任意の場所へ展開してください。

どのバージョンの LÖVE がインストールされているか知るには、下記のコマンドを実行してください:

love --version

ゲームの作成

最小のゲームを作成するには、フォルダを任意の場所へ作成して、お好きなテキストエディタで開いてください。 Sublime Text は全てのオペレーティング・システムに対して非常によいものであり、標準で Lua 言語への対応機能が組み込まれています。作成済みのフォルダへ新規ファイルの作成を行い、 main.lua の名前を付けて、下記のコードをファイルへ記述してから、保存してください。

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

ゲームの実行

LÖVE は二種類の方法でゲームを起動することができます:

  • main.lua ファイルのあるフォルダーから。
  • .love ファイルの最上位(別名ルート)ディレクトリ内にある main.lua ファイルから。

.love ファイルの作成方法は Game Distribution を参照してください。


Windows

ZeroBrane Studio, Sublime Text 2, Notepad++, および SciTE はコード・エディタからゲームを起動することができます。

それ以外に、ゲームを実行する最も簡単な方法は 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"

単に love.exe のショートカットを作成をしてショートカットを右クリック、次に"プロパティ(R)"を選択してからショートカットに対する"リンク先(T)"にあるボックスへ希望するコマンドラインを記述してください。

Windows では、print 呼び出しの結果を参照できるようにするために、ウィンドウにコンソールを接続する特別なコマンドライン・オプションがあります (conf.lua にて t.console=true を設定するのと等価です):

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

Linux

Linux では、どちらのコマンドラインを使用することができます:

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

LÖVE がシステム全体にインストールされている場合は、ファイル・マネージャーから .love ファイルをダブルクリックすることでもゲームを起動できます。


Mac OS X

Mac OS X では、フォルダまたは .love を love アプリケーション・バンドルへドロップすることができます。 Mac ターミナル (コマンドライン)では、このように使用できます (アプリケーションのディレクトリへインストールされていると仮定します):

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

しかし、上記の方法ではターミナルのウィンドウへ表示されたテキストを出力しません。出力を行うには、アプリケーション・バンドル内部にある love バイナリを直接実行する必要があります:

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

~/.bash_profile へエイリアスを追加して love を使用する場合はターミナル・セッションにてエイリアスを設定することができます。

ファイルを開きます

open -a TextEdit ~/.bash_profile

下記のコマンドを実行します

touch ~/.bash_profile

最初に、まだファイルが存在しない場合です。

次に下記のコードを貼り付けてファイルを保存してください:

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

今後は Linux および Windows と同様にコマンドラインから love を呼び出すことができるようになります:

love "~/path/to/mygame"

Android

LOVE アプリを Google Playストアまたは別の配布元からインストールしている場合に限り、次の方法で動作します:

  • 方法1 main.lua が /sdcard/lovegame/main.lua で検出されるようにするためにゲームフォルダーを /sdcard/lovegame へ転送します。その後にアプリを実行します。
  • 方法2 ゲームの .love ファイルをデバイスへ転送してからクリックします。大抵のファイル管理ソフトは LOVE アプリ使用して .love アプリを動作せます。それができない場合は ES ファイルエクスプローラーをインストールすることで動かせるようになります。 Dropbox を使用する場合は、それを .love ファイルを開くために使用することができます。



iOS

iOS で LÖVE 実行するためには、まずコンパイルとインストールが必要です。この作業を行うには、 Mac OS X, Xcode 7 以降、そしてホームページからダウンロード可能な LÖVE の iOS 版ソースコードが必要です。

  • include および libraries フォルダに love/platform/xcode/ios フォルダが存在しない場合は、それらをダウンロードしてから対象フォルダへ導入してください。そのファイルには LÖVE で使用されているサードパーティーに依存するライブラリが同梱されています。
  • love/platform/xcode/love.xcodeproj にある Xcode プロジェクトを開いて、ウィンドウの上部にあるドロップダウンメニューから love-ios ターゲットを選択します。
  • 実行効率をもっと良くするためにビルド構成をデバッグからリリースへ変更したい場合は、同じドロップダウンの選択から "スキームの編集..." メニューを開きます。
  • 右方前にあるドロップダウンから iOS シミュレーターまたは接続済みの iOS デバイスを選択して、左方の「ビルドと実行ボタン ▶︎ 」をクリックすることで コンパイル後に対象デバイスへ LÖVE がインストールされます。

iOS 版の LÖVE にはインストール済みゲームの簡素な一覧表示インタフェースが組み込まれています (配布用に .love をヒューズ化するまで使用できます)。

  • LÖVE のインストール後に iOS シミュレータへ .love ファイルを導入するには、ウィンドウを開いている時に iOS シミュレータのウインドウへファイルをドラッグしてください。まだ実行していない場合は、 LÖVE を起動します。新たにゲームを表示するために別のゲームを現在実行中の場合は LÖVE を終了する必要がある場合があります (iOS シミュレーターのアプリの切り替えメニューを開くには Shift-Command-H を二回打鍵してください)。
  • LÖVE のインストール後に iOS デバイスへ .love ファイルまたはゲームのフォルダを導入するには、 Safari でダウンロード、またはデバイス接続時にコンピューターから iTunes を経由して転送できます。 iTunes を開き、 LÖVE をインストールした iOS デバイスへ移動し、 ‘アプリ’ の項目へ移動、および下方へスクロールしてLÖVE を見つけ出してから、 LÖVE の書類項目へ .love ファイルあるいはゲームフォルダーを追加します。

iOS 版での LÖVE ゲームのヒューズ化作成および配布方法に関してはGame Distribution を参照してください。

次の段階

そのほかの言語