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

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

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

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


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

• Lion 以降の 64bit Intel 搭載 Mac (10.7+)
• Xcode（App Store で入手可能な、バージョン４以降の IDEがサポートされています）
• Clang と libc++（Xcodeとともにデフォルトで付属）

macOS では、２通りのフォーマットで SFML を使うことができます。
１つは dylib ライブラリ。もう１つはフレームワークのバンドルです。

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

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

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

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

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

なにはともあれ、まずはダウンロードのページで SFML の SDK をダウンロードしましょう。 そして、SFMLアプリの開発の準備として、下記のものをインストールしましょう：

• ヘッダーファイルとライブラリ
  SFML は dylibsか、またはフレームワークとして使うことができます。 両方同時にインストールすることもできますが、必要なのはどちらか片方だけです。 オススメはフレームワークの方です。
  
  • フレームワークの場合
    Frameworks フォルダの中身を /Library/Frameworks フォルダへコピー。
  • dylib の場合
    lib フォルダの中身を /usr/local/lib フォルダへコピー。
    include フォルダの中身を /usr/local/include フォルダへコピー。
• SFML が依存しているライブラリ
  macOS環境では SFML が依存している外部ライブラリがいくつか存在します。
  extlibs フォルダの中身 を /Library/Frameworks フォルダへコピーしてください。
  
  
• Xcode のテンプレート
  必須ではありません。が、インストールしておいた方が絶対いいです。
  templates フォルダの中の SFML フォルダを /Library/Developer/Xcode/Templates フォルダへコピー （フォルダがないときは作っておきましょう）。

Xcode 用に、２つのテンプレートがあります。
SFML CTL で従来通りのターミナルアプリケーションのプロジェクトを生成することができます。
一方、SFML App では、アプリケーションバンドルのプロジェクトを生成することができます。
このチュートリアルでは後者を使いますが、どちらでも仕組みは大体同じです。
まずは、"File > New Project" を選択。 そして 画面左の SFML を選択し、SFML App をダブルクリックします。

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


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

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

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

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

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