メインコンテンツまでスキップ

Projucerパート2:Projucerプロジェクトを管理する

📚 Source Page

Projucerパート1:Projucerを始める では、新しいJUCEプロジェクトを作成し、それをネイティブIDEにエクスポートし、コーディングを開始する方法を学びました。 しかし、Projucerはそれだけではありません。 プロジェクトのすべての設定を管理したり、ソースファイルを追加したりするための非常に強力なクロスプラットフォームツールでもあります。 あなたがJUCEアプリケーションを開発するとき、Projucerはそのプロセスを通してあなたの忠実な伴侶となるでしょう。 このチュートリアルでは、いくつかの重要な機能の概要を説明します。

レベル:初級

プラットフォーム:Windows, macOS, Linux, iOS, Android

はじめよう

新しい JUCE プロジェクトを作成し、Projucer で開きます。これは チュートリアル:Projucerパート1:Projucerを始める で説明されています。

Projucerプロジェクトの構造

Projucerプロジェクトの構造を詳しく見てみましょう。 以下は、Projucerが生成するJUCEプロジェクトのフォルダ構造です。

Projucerプロジェクトの解剖
Projucerプロジェクトの解剖

一番上のレベルには .jucer ファイル(上でハイライトされている)があり、すべてのプロジェクト設定が含まれています。 このファイルをダブルクリックすると、Projucerでプロジェクトが開きます。 .jucer ファイルの他に、3つのサブフォルダが生成されます

フォルダ内容
SourceJUCEアプリのC++ソースコード
BuildsProjucerによって生成されたエクスポートターゲット。上のスクリーンショットでは、Xcode プロジェクトファイルと Visual Studio ソリューションが例として強調表示されています。これらのファイルを開いて、JUCEアプリのコーディング、デバッグ、実行を開始します。(もちろん、Projucer の Open in ... ボタンを使用することもできます)。
JuceLibraryCodeここに、JUCEモジュールを介してJUCEライブラリのコードをインクルードする自動生成ヘッダファイルをいくつか示します。実際のJUCEライブラリのコードはここにはなく、先にインストールしたグローバルJUCEフォルダの中にあることに注意してください。

プロジェクトの管理

それでは、JUCE アプリを開発する際に頻繁に使用する Projucer の最も重要な機能を見ていきましょう。

ソース・ファイルの追加と編集

Projucer は C++ ソース・ファイルのためのファイル・ブラウザと基本的なコード・エディタを提供します。 これは左側のファイル・エクスプローラ・タブの下にあります。こんな感じです

Projucerのファイルナビゲータ(左)とソースファイルエディタ(右)
Projucerのファイルナビゲータ(左)とソースファイルエディタ(右)

Projucerでは、プロジェクトに新しいソースファイルを追加したり、既存のファイルを削除したり、名前を変更したり、ファイルをグループに整理したりすることができます。 これを行うには(他の機能にもアクセスするには)、左側のファイルエクスプローラタブで「+」マークをクリックするか、 ファイルまたはグループを右クリックして、ポップアップメニューからやりたいことを選択します。

注記

グループはフォルダと同じではありません。 Projucer でグループ内にファイルを作成すると、ファイルをどのフォルダに保存するかも尋ねられます。 これにより、グループ構造とは異なるフォルダ構造を持つことが可能である。 しかし、グループがフォルダの構造と名前に従うようにすることは、非常に推奨され、良い習慣です。

ファイル構造を変更してからプロジェクトを保存すると、エクスポートされるすべてのネイティブ IDE プロジェクトに変更が反映されます。 このようにして、開発するすべてのプラットフォームで、プロジェクトのファイル構造を簡単に一貫性を保つことができます。

警告

ネイティブ IDE (Xcode, Visual Studio など) 内で、JUCE プロジェクトからソース・ファイルを追加、名前変更、および/または削除してはいけません。 これらの変更は、次に Projucer でプロジェクトを保存したときに上書きされてしまいます (ネイティブ IDE プロジェクトは毎回再生成されます)。 このような変更を行うには、常にProjucer自体を使用してください。

Projucer のコード・エディタは、ファイル・ブラウザでファイルを選択すると表示される。 コードに素早く変更を加えるには、ネイティブIDEを起動する必要はなく、Projucerで変更を加え、変更を保存するだけでよい。

JUCEモジュールの管理

JUCEライブラリのコードは、様々なモジュールに整理されています。 デフォルトでは、プロジェクトのタイプに必要なすべてのモジュールが追加されています。

このプロジェクトで使用されているJUCEモジュール(左、ハイライト)とモジュール設定ページ(右)
このプロジェクトで使用されているJUCEモジュール(左、ハイライト)とモジュール設定ページ(右)

ほとんどの JUCE モジュールは、適切にコンパイルするために他の JUCE モジュールを必要とします。 もし、あなたのプロジェクトの他のモジュールが依存しているモジュールを削除した場合、Projucer は "壊れた" モジュールを赤くハイライトします。 そして、"壊れた "モジュールを削除するか、足りないモジュールを追加しなければなりません。

モジュールタブで設定アイコンをクリックすると、モジュール設定ページが開きます。 現在使用されているすべてのモジュールの概要が表示され、モジュールのパスを設定することができます。 すべてのモジュールのパスを一度に変更するには、モジュールの一つに正しいパスを入力し、それを選択し、すべてのモジュールのパスを設定...をクリックします。

または、 Enable/disable global path for modules... をクリックして、モジュールのグローバル検索パスを使用することもできます。 グローバル検索パスを設定するには、MacOSではメニューの Projucer > Global Search Paths、WindowsとLinuxではFile > Global Search Pathsに移動します。

ブラウザで個々のモジュールをクリックすると、モジュール固有の設定とプロパティにアクセスできます。 そこで、特定のモジュールのバージョンとライセンスをチェックし、特定のモジュールが使用しているSDKや外部ライブラリなどの追加依存関係へのパスを設定することができます。 通常、デフォルトの設定で問題なく動作するので、このページに入る必要はほとんどないはずです。

エクスポートターゲット、コンフィギュレーション、ビルド設定

先に作成したさまざまなエクスポートターゲット(Xcode、Visual Studioなど)は、Exportersタブで見つけることができます。 ブラウザでこれらをクリックすると、このエクスポートターゲットのビルド設定にアクセスできます。 ここで、追加のコンパイラやリンカのフラグ、その他のプラットフォーム固有のビルド設定を指定します。

IDEとプラットフォームを追加して新しいエクスポート・ターゲットを作成するには、「+」マークをクリックしてください。 これはいつでもできます。 例えば、元々Windows と OSX 用の JUCE アプリケーションを作成した後で、Linux のサポートも追加することにした場合、簡単にそれを行うことができます。

また、エクスポートターゲットを右クリックして、Delete this exporter を選択すれば、エクスポートターゲットを削除することもできます。

Projucer は各エクスポート・ターゲットにビルド・コンフィギュレーションを作成し、ネイティブIDEが実際にアプリをコンパイルして実行する際に使用します。 デフォルトでは、DebugとRelease の2つのコンフィギュレーションが各エクスポート・ターゲットに追加されます。 これらのコンフィギュレーションをクリックすると、この特定のコンフィギュレーションのプラットフォーム固有のビルド設定にアクセスできます

さまざまなIDE構成(左、強調表示)と構成固有のビルド設定(右)
さまざまなIDE構成(左、強調表示)と構成固有のビルド設定(右)

追加設定も可能です。 例えば、Visual Studioエクスポート・ターゲットの場合、Projucer は64ビットを使用する Debug と Release のコンフィギュレーションを追加します。 しかし、Windowsアプリに32ビット・サポートを追加したい場合もあるでしょう。 この場合、既存の2つの構成をコピーし(構成を右クリックし、Create a copy of this configurationを選択)、 コピーの名前をそれぞれDebug32とRelease32に変更し、両方の構成のビルド設定Architectureを64ビットから32ビットに変更します。

概要

このチュートリアルを読めば、次のことができるようになるはずだ:

  • Projucer を使ってソースファイルを編集し、JUCE モジュールを管理する
  • アプリのビルド設定を構成する
  • 新しいエクスポート・ターゲットとビルド設定を作成する

関連項目