HSP : HSP3Dish / onion software 2017(c)

# HSP3Dish iOS版 XCode5設定ガイド

1. はじめに
2. XCode5プロジェクトの作成
3. HSP3Dish関連ファイルの登録
4. XCode5.1以降の設定

## はじめに

このマニュアルでは、iOS版のHSP3Dishをビルドするために、XCode5で新規プロジェクトを生成するための手順を説明しています。
現在、最新のHSP3Dish開発環境ではHSP3Dish HelperがXCode5用のプロジェクトファイルを出力する形になっています。 このガイドでは、手動でXCode5のプロジェクトを生成する場合に参考にしてください。 開発環境やスクリプトの準備は、通常の方法と同様です。 特に問題がない場合は、HSP3Dish Helperが出力するプロジェクトファイルをお使い頂くことを推奨しています。

## XCode5プロジェクトの作成

現在のiOS開発環境最新版は、XCode5となります。 以前のバージョンとなる、Xcode4を使用するためのガイドはこちらを参照してください。

OSX上でXcode5を起動して新規プロジェクト(Create a new Xcode project)を選択します。 テンプレートの選択画面になりますので、「iOS Application」の「Empty Application」を選び「Next」を押してください。

オプション画面で、製品名(Product Name)入力します。
識別子(Company Identifier)は、作成者を識別する名前(メーカー名など)を入力します。
Device FamilyはiPhoneやiPadなどの任意のデバイスを設定します。その他の項目は、基本的にはそのままにしておいてください。

次に、プロジェクトのフォルダを作成する場所を設定します。これは任意の場所を指定して構いません。
正常にプロジェクトが作成されると、開発環境(IDE)が起動します。
メインウィンドウにプロジェクトの概要(General)が表示されるはずです。

HSP3Dishでは、最低動作バージョン(Deployment Target)を4.3に指定することを推奨しています。 XCode5でこの設定を変更するためには、最初にプロジェクトのビルド設定(Build Settings)タブのArchitecturesを 変更する必要があります。デフォルトでは、64bitアーキテクチャを含む設定になっているので、 これをStandard(armv7,armv7sのみ)にしてください。 これにより、Deployment Targetを4.3に指定することが可能です。

さらに、コンパイラの設定を以下のように変更する必要があります。
プロジェクトのビルド設定(Build Settings)タブの「Apple LLVM 5.0 - Language - Objective C」項目、「Objective-C Automatic Referece Counting」を「No」に変更します。

同じく、ビルド設定(Build Settings)タブの「Apple LLVM 5.0 - Language」項目、「C Language Dialect」を「GNU99 [-std=gnu99]」に変更。
「Apple LLVM 5.0 - Language - C++」項目、「C++ Language Dialect」「C++ Standard Library」をすべて「Compiler Default」に変更。
「Apple LLVM 5.0 - Language - Modules」項目、「Enable Modules (C and Objective-C)」「No」にそれぞれ変更してください。

最後にビルド設定(Build Settings)タブの「Packaging」項目、「Compress PNG Files」を「No」に変更するのを忘れないでください。

以上で新規プロジェクトファイルの設定が完了します。
尚、以前のXCodeで作成されたプロジェクトファイルは問題なく読み込みビルドすることが可能です。

## HSP3Dish関連ファイルの登録

作成されたプロジェクトのフォルダと同じ階層に、「iHSP20」フォルダを配置してください。 「iHSPxx」フォルダはアーカイブ内のiOSフォルダに同梱されています。

XCode上でプロジェクトに必要なファイルを追加してください。
Fileメニューから、「Add Files to〜」を選択し、「iHSP20」のフォルダ(下層も含む)を追加(Add)します。
さらに、Windows上で作成されたCソースファイル(拡張子が.cppのファイル)を追加(Add)します。

続いて、プロジェクトにフレームワークの追加を行ないます。以下のフレームワークを追加してください。

- AudioToolbox.framework
- OpenAL.framework
- OpenGLES.framework
- QuartzCore.framework
- iAd.framework

フレームワークの追加は、プロジェクトの「General」タブの「Linked Frameworks and Libraries」項目の「+」ボタンで行なうことができます。

プロジェクトの「Summary」タブで、サポートされる画面の方向、ステータスバーの表示設定(フルスクリーンにする場合は、Hide during application launchにチェックを入れる)を行なってください。

アイコンやデータファイル(画像やサウンド)がある場合は、「Resource」フォルダを作成してプロジェクトに追加(Add)してください。(サンプルプロジェクトのResourceフォルダなどを参考にしてみてください)

以上で、HSP3Dish関連ファイルの登録が整いました。
アプリアイコンやスタートアップスクリーンなどは、必要に応じて登録を行なってください。

新規プロジェクトを作成した場合は、デフォルトでビルドスキームがDebugになっています。 ProductメニューのEdit Scheme...の設定で、Build Configurationを「Release」に変更することで、最適化されたコードが出力され、より高速に実行されます。

## XCode5.1以降の設定

XCode5.1以降では、64bitアーキテクチャがデフォルトで指定されているため、それまでのプロジェクトをコンパイルしようとする場合にもエラーとなってしまいます。 これを解決するには、プロジェクトのBuild Settingsタブにある、「Architectures」内の、「Architectures」項目が「$(ARCHS_STANDARD)」になっているのを、「$(ARCHS_STANDARD_32_BIT)」に変更します。
変更後に、プロジェクトを一度クリーン(ProductメニューのClean項目)してから、再度ビルドを行なうようにしてください。