プロジェクトを開始する

プロジェクトを作るには、ターミナル.app でプロジェクトフォルダを作りたいディレクトリに移動し、次のコマンドを入力。

$ motion create <プロジェクト（アプリケーション）名> --template=osx

これで、プロジェクトフォルダができて、その中に必要なファイルがコピーされる。

この他にも、ここ (GitHub) から、Document-based Application や、nib ファイル伴う（Cocoa Application のような）テンプレートがダウンロードできる。

$ motion create <プロジェクト（アプリケーション）名> --template=osx-doc-based

$ motion create <プロジェクト（アプリケーション）名> --template=osx-with-nib

ib を使う場合は、最初からこのどちらかを使った方が楽。

標準テンプレートを使った場合は、プロジェクトファイルができたら、プロジェクトフォルダに移動して、

$ rake

で、コンパイルして実行する。

標準では、すべてスクリプトで処理していくことになるので、UI もすべてスクリプトで書いていくことになる。いろいろと便利なラッパーも用意されているようだが、Xcode の Interface Builder を使いたいので、ib という Interface Builder をサポートするラッパーを使う。詳しくは、Git Hub のページを参照してください。

また、

まずは、インストール。今後も楽をしたいので、まずは、bundler という、application dependency を管理する gem を使うと便利そうなので、使ってみた。Bundler がインストールされていない場合は、まず、

$ sudo gem install bundler

として、bundler をインストール。そしたら、プロジェクトフォルダ内にある Gemfile に

gem 'ib'

という一行を加えて、ターミナル.app に戻り、プロジェクトフォルダ内に移動して、

$ bundle

を実行する。

上記の、標準以外のテンプレートを使った場合は、IB と CocoaPods を使うことが前提となっているので、gem 'ib' は既に Gemfile に書いてある。また、bundle を実行すると、motion-cocoapods があるため、追加で gem のインストールを促されるので、それぞれ sudo を付けてインストールする。

また、CocoaPods の依存関係がないと出てくるので、

rake pod:install

を実行する。これで初めて rake できるようになる。

次に、スクリプトのクラス内で、

extend IB

と入力し、IBOutlet を指定していく。outlet は Interface Builder 上で管理したいパーツに付けるラベルみたいなものと考えたらいい。MacRuby では、attr_accessor で outlet にしたいものを指定しただけだが、ここでは、outlet で、ラベルとクラスの指定をする。もしかしたら、クラスは指定する必要はないのかもしれない。指定すると、指定したクラスのオブジェクトとしか接続できなくなる。id での指定もできるように書いてあるが、わからないので試していない。

outlet :startBtn, NSButton

IBAction は、MacRuby と同様に、

def beginProcess(sender)

    ここに処理を書く。

end

と、メソッド定義で、引数を sender にする。

これで、ターミナル.app に戻って、

$ rake ib:open

を実行する。（これは、スクリプト側で outlet もしくは action を追加・変更するたびに実行する。）

これで、プロジェクトフォルダ内に、ib.xcodeproj というファイルができて、Xcode で開く（ファイルをダブルクリックしても開く）。

開いたら、Xcode で Resources フォルダに必要なタイプの xib ファイルを追加する（MacRuby のプロジェクトを移植する場合など、すでに xib ファイルがあれば、リソースフォルダにコピーすると認識される）。追加したら、xib ファイルを開いて、File's Owner を選択し、Identity Inspector（右側コラムの一番上の左から 3 番目のアイコン）を選んで、Custom Class で、接続したい outlets や actions を指定したクラスを選ぶ。これで、File's Owner を右クリックすると、それらが現れるので、UI パーツと結びつける。終わったら保存して、ターミナル.app で rake を実行する。

今のところ、メニューを IB でどうにかする方法はわからない。AppDelegate 自体も、どう処理していいかよくわからない。つながるときもあるので、もう少しゆっくり見てみる必要があるか。

例えば、ウィンドウ一つのアプリケーションを作る場合、テンプレートの app_delegate.rb の最初は、

def applicationDidFinishLaunching(notification)

    buildMenu

    buildWindow

end

となっていて、buildWindow は同一ファイル内で定義し、buildMenu は別ファイルで定義している。デフォルトでは、buildWindow でスクリプトでウィンドウを描いているが、これを IB で扱いたいので、 Xcode 上で、Resources フォルダを二本指クリックして New File... で左の User Interface を選んで、Window を選び、MainWindow.xib を作る。

そして、app_delegate.rb に戻って、次のように書く。

def buildWindow

    @mainWindowController = MainWindowController.alloc.initWithWindowNibName('MainWindow')

    @mainWindowController.window.makeKeyAndOrderFront(self)    

end

プロジェクトフォルダの app フォルダに、main_window.rb（ファイル名は任意）というファイルを作り、

class MainWindowController < NSWindowController

    extend IB

    outlet :text, NSTextField

    outlet :startBtn, NSButton

    def startProcess(sender)

        @text.setStringValue("Start!")

    end

end

というような感じで、スクリプトを書く。スクリプトを書いたら、上に書いたように、rake ib:open を実行する。

また、Xcode に戻って MainWindow.xib を開き、NSWindow のパーツを配置し、その上に、Label (NSTextField) と適当な Button (NSButton) を配置し、File's Owner を二本指クリックして、それぞれの Outlet と Action をパーツと結びつける。

最後に、アプリケーションの名前と、ビルドターゲットを指定する。Rake ファイルを開くと、app.name でアプリケーションの名前が指定してある。デフォルトでは、プロジェクト名が入っている。ビルドターゲットは、開発環境の OS のバージョンになるようなので、それより前のバージョンの OS X でも動作させたいときは、app.deploy_target で指定する。

app.name = 'Application Name'

app.deployment_target = "10.7"

QTKit, WebKit, PDFKit (Quartz) などのフレームワークを読み込む必要があるときも app.frameworks に追加する。

app.frameworks << 'QTKit'

app.frameworks << 'WebKit'

app.frameworks << 'Quartz'

あと、確認していないが、Xcode の Interface Builder 上でも、OS のバージョンを指定する必要があるかもしれない。xib ファイルを選んで、右側のインスペクタの一番左の File Inspector を選び、Interface Builder Document の Builds for で、サポートしたいバージョンを指定する。10.7 の場合は、OS X 10.7 and Later を選ぶ。