Xcode で SFML を使ってみたい？
というか、Mac OS X でアプリ開発をしたい？
そんなアナタのために！ このチュートリアルがあります。

SFML をどうやってインストールするのか？
IDE をどんなふうに設定するのか？
そして SFML の基礎的なプログラムを書くまでのご案内です。

そして忘れてはいけないことがもう１つ。
作ったアプリを、ユーザーさんがすぐに使える状態で配布するにはどうすればいいのか？
それについてもご紹介します。

このチュートリアルの中で、重要な部分には、 さらに詳しい解説ページへのリンクを張ってあります（別サイトへ。アップルの公式サイトなど）。 興味のある方は、そちらも読んでみてください。
このチュートリアルの内容そのものは、リンク先を読まなくても、ついて行けると思います。


SFML を使ったアプリを開発するために必要なのは：

• Leopard 以降の Intel 搭載 Mac
• Xcode（できれば、App Store で入手可能な、バージョン４の IDE）

Mac OS X では、２通りのフォーマットで SFML を使うことができます。
１つは dylib ライブラリ。もう１つはフレームワークのバンドルです。
どちらも ユニバーサルバイナリとして提供されてます。 なので、32ビットマシンでも 64ビットマシンでも、特に気にしないで使うことができます。

Dylib は ダイナミックライブラリの略です。
このフォーマットは Linux でいうと ".so" のライブラリみたいなものです。
もっと詳しく知りたい方は、 こちらのページをどうぞ（アップルのサイトです）。

フレームワークも、根本的には dylibs と同じです。 違いは、外部リソースをカプセル化できるところです。
詳しいお話は、 アップルのサイトの解説をご覧くださいませ。

SFML でアプリ開発をする場合、１つだけ、両フォーマットの微妙な違いを知っておいて下さい。
SFML そのものを自前でビルドした場合は dylib 形式で、デバッグ版もリリース版も両方生成できます。 が、フレームワークではリリースビルドしかできないのです。
最終的に完成品をリリースするときには、どっちにしてもリリースビルドをすることになるので、 問題にはならないと思います。
と、そんなわけで、ダウンロードページに置いてある OS X 用の SFML ライブラリは、 リリースフォーマットの分しかないのでした。

Xcode4 用に、SFML は２通りのテンプレートで提供されてます。 これを使うと手早く簡単にプロジェクトを構築できます。

テンプレートでカスタムプロジェクトを生成できます：
SFML を dylib として使うかフレームワークとして使うかに関わらず、 開発するアプリケーションがどのモジュールを使うのか、どのコンパイラを使うのか、を選択できます。 そして、リソースを全部含んだアプリケーションバンドルを生成するのか （アプリケーションのインストールプロセスはドラッグアンドドロップのような簡単な操作で作れます）、 それとも従来通りのクラシックなバイナリを生成するのかを選択できます。 詳しくはこのチュートリアルの続きをご覧ください。

アップルは Xcode4 に同梱して clang や libc++ のカスタムバージョンを出荷してます。 C++11 の仕様を部分的にサポートしています（でも全機能ではない）。
C++11 の新機能を使う予定なら、プロジェクトを clang や libc++ を使うように設定します。 そして、正しいバージョンをダウンロードしてくださいね（詳しくは後述）。

なにはともあれ、まずはダウンロードのページで SFML の SDK をダウンロードしましょう。

SFMLアプリの開発の準備として、下記のものをインストールしましょう：

• ヘッダーファイルとライブラリ
  このチュートリアルの冒頭でも書いたように、SFML は dylibsか、またはフレームワークとして使うことができます。 フレームワークの方がオススメですが、両方インストールしておくことも可能です。
  
  • dylib の場合
    lib フォルダの中身を /usr/local/lib フォルダへコピー。
    include フォルダの中身を /usr/local/include フォルダへコピー。
  • フレームワークの場合
    Frameworks フォルダの中身を /Library/Frameworks フォルダへコピー。
• SFML が依存しているファイル
  Mac OS X の場合、SFML が依存しているファイルは２つだけです。
  extlibs フォルダの中の sndfile.framework と freetype.framework を /Library/Frameworks フォルダへコピー。
  
  
• Xcode のテンプレート
  必須ではありません。が、インストールしておいた方が絶対いいです。
  templates フォルダの中の SFML フォルダを /Library/Developer/Xcode/Templates フォルダへコピー （必要があれば、フォルダの階層を作っておきましょう）。

install.sh というスクリプトが SFML に同梱されています。 このスクリプトがインストール作業を全部やってくれます。 このスクリプトは以前のバージョンの SFML（特にフレームワーク）を削除しないので、 元々あったアプリケーションを変更しなくても済みます。
スクリプトを実行するには SFML の SDK をダウンロードしたディレクトリでターミナル画面を開いて ./install.sh を実行するだけです。 パスワードを入力するようにプロンプトが出ます。 その後は、全てを正しい場所にインストールしてくれます。

Xcode 用に、２通りのテンプレートがあります。
SFML CTL で従来通りのターミナルアプリケーションのプロジェクトを生成することができます。
一方、SFML App では、アプリケーションバンドルのプロジェクトを生成することができます。

まずは、"File > New Project" を選択。 そして 画面左の SFML を選択し、SFML App をダブルクリックします。

スクリーンショットを参考に、項目を埋めていきます。そして「Next」を押下。


これで、この新規プロジェクトは ".app" というアプリケーションバンドル に設定されました。

• GCC用の SFML を使っている場合は "C++98 with GCC and libstdc++ and target 10.5." を選択
• Clang用の SFML を使っている場合は "C++11 with Clang and libc++" を選択
• SFML をソースからコンパイルした場合は……どのオプションにすればいいかはわかりますよね？

これでプロジェクトの準備は完了です。
中身を見てみましょう：

ご覧のように、プロジェクトには最初からファイルがいくつかあります。
以下、その中の重要なものです：

• 1. ヘッダー＆ソースファイル：
  "ResourcePath.hpp" に std::string resourcePath(void); というヘルパー関数が書かれていて、 その使用サンプルが "main.cpp" に載っています。
  この関数を使うとアプリケーションバンドルの Resources フォルダへ簡単にアクセスできます。 ただし、この関数が使えるのは Mac OS X だけです。 開発したアプリを他の OS で動かす場合は、その OS 用にヘルパー関数の内部実装を変更して下さい。
  
  
• 2. リソースファイル（Resource）：
  上記の "main.cpp" に書かれているサンプルで使っているリソースがこのフォルダに入っています。
  ソースをコンパイルすると、アプリケーションバンドルに自動的にコピーされます。
  プロジェクトに別のリソースを追加するには、このフォルダにドラッグ＆ドロップすれば OK です。
  そして、アプリケーションターゲットのメンバーにするのを忘れないで下さい （"Target Membership" 欄（cmd + alt + 1 でオープン）の中のチェックボックスが選択されていること）。
  
  
• 3. Product：
  開発しているアプリケーションです。 "Run（実行）" ボタンでテストできます。
  

他のファイルは、ここでは特に気にする必要はありません。
ただし、SFML が依存しているファイルもアプリケーションバンドルに追加されるので覚えておいて下さい （リソースがコピーされるのと同じようなものです）。 このおかげで、作ったアプリを、すぐに実行できる状態で配布することができます。 他のマシンで動かすとき、SFML や依存ファイル群を別個にインストールする必要がありません。