チュートリアルProjucerパート1：Projucerを始める
このチュートリアルでは、JUCE のインストール方法と、Projucer を使用して新しいクロスプラットフォーム JUCE プロジェクトを作成する方法を説明します。また、JUCE アプリケーションを開発、実行、デバッグするために、プロジェクトを Xcode や Visual Studio などの IDE にエクスポートする方法も学びます。
レベル：初級
プラットフォーム：Windows, macOS, Linux, iOS, Android
はじめる
JUCEをダウンロード. Unpack the JUCE folder and place it to some location on your computer. Your user home folder is a convenient place.
先ほどインストールしたJUCEフォルダに入ります。そこにあるProjucerを起動します。
The new project window
The first time you launch Projucer, you are presented with the new project window. (You can also launch this later by selecting 新プロジェクト from the Projucer's main menu.):
Select your project type
ウ ィンドウの左側で、作成したいプロジェクトのタイプを選択します。
プロジェクト・タイプごとに、Projucerはすべてのプロジェクト・ファイルを生成し、すべてをセットアップする適切な最小限のコードを追加します。このようにして、プロジェクトを作成した後、すぐに実際の機能の開発に取り掛かることができます。
初めてJUCEを使う場合で、何から始めたらよいかわからない場合は、GUIアプリケーションを使いましょう。
以下は、現在サポートされているすべてのプロジェクトタイプの概要です。
| プロジェクトの種類 | 説明 |
|---|---|
| アプリケーション/ブランク | これにより、空白のJUCEアプリケーションが作成されます。 |
| アプリケーション/GUI | これにより、空のアプリケーション・ウィンドウを持つ最小限のJUCEアプリケーションが作成されます。ここから始めて、JUCEが提供する様々なクラスを使って、より多くのGUIコンポーネントなどの機能を追加することができます。 |
| アプリケーション/オーディオ | This creates a minimal JUCE application, like アプリケーション/GUI, but automatically adds all the setup code that you need to easily get audio input and output. You can use this for games, multimedia applications, and much more. |
| アプリケーション/コンソール | JUCEは、GUIを全く持たないコマンドラインアプリケーションを開発するのにも非常に便利です。そのようなアプリケーションを作成するには、このプロジェクト・タイプを使ってください。 |
| アプリケーション/アニメーション | これは、アニメーションのグラフィック表示を描画するアプリケーションを作成します。ここから始めて、例えばアニメーション・モバイル・アプリケーションを作成することができる。 |
| アプリケーション/OpenGL | This creates a blank JUCE application, like アプリケーション/GUI, but adds support for OpenGL to draw features including 3D model import and GLSL shaders. |
| プラグイン/ベーシック | This creates a basic audio plug-in. All the code to support VST, AudioUnit and AAX plug-in formats, is added automatically. Depending on your setup, this project type may require some additional preparation steps to work correctly. See チュートリアル基本的なAudio/MIDIプラグインを作る, パート1：セットアップ for more information. |
| ライブラリ/静的, ライブラリ/動的 | このプロジェクト・タイプは、JUCEの上に構築する再利用可能なソフトウェア・ライブラリを作成するのに便利です。Projucerは、静的リンクと動的リンクの両方のライブラリの作成をサポートしています。 |
There are also many example projects which can serve as an alternative starting point for your project, They are located in the subfolder JUCE/例 and can be browsed by clicking the オープン例 tab.
You are not limited by the project type you choose; for example, if you selected アプリケーション/GUI, you can always add animations and OpenGL later. However, you cannot easily convert an Application to a Library or an Audio Plug-In later.
Create your new project
適切なプロジェクトタイプを選択した後、ウィンドウの右側にある追加のプロジェクト設定を入力することができます：
- プロジェクト名 - Here, you choose a name for your app.
- モジュール - The JUCE framework code is organised into モジュール. Here, you can select which modules are included in your project and in the section below you can specify the location of the
モジュールsubfolder located inside the JUCE folder you installed earlier. - 輸出業者 - Here, you select which native IDEs you want to use to build and debug your app. This also defines the desktop and mobile platforms that your app will support. Don't worry, this is not a final choice — with the Projucer, you can add additional platforms and IDEs later.
Projucerには現在、以下のIDE、ビルド・システム、プラットフォーム用のエクスポータがあります：
| 対象OS | 対応ビルドシステム |
|---|---|
| オーエスエックス | エックスコード |
| ウィンドウズ | ビジュアルスタジオ、Code::Blocks |
| リナックス | Makefile, Code::Blocks |
| iOS | エックスコード |
| アンドロイド | アンドロイドスタジオ |
- ファイル Creation Options - Depending on the project type, this field may offer some options on what code to auto-generate. If you are new to JUCE, the default selection is usually the best way to go to auto-generate everything you need and get you going quickly.
- When you have reviewed all your settings, click the プロジェクトを作成... button to generate the project at a specified location.
Export the project and open in your native IDE
プロジェクトを作成したら、Projucerから直接ネイティブIDEを起動することができます。一番上のボタンを使ってください：
IDE（Xcode、Visual Studioなど）を開いたので、JUCEアプリをコンパイルして実行し、コーディングを始めることができます！
使用する前に、適切なネイティブIDE/ビルド・システムをコンピューターにインストールする必要があります。プラットフォームによっては、追加の依存関係をインストールする必要がある場合もあります。たとえば、Android向けに開発するにはAndroid SDKをインストールする必要があります。
All export targets (which are the native IDE projects) are generated when you create your Projucer project. They are also updated every time you save it in the Projucer. At any time, you can create new export targets to add support for more IDEs and platforms to your project. You can read about this and more features for managing your Projucer project in チュートリアルProjucerパート2：Projucerプロジェクトを管理する.
Open an existing project
To open up an existing Projucer project, you can either double-click on the ジュセール file contained in the project folder or click on 既存のプロジェクトを開く from the wizard. (You can also navigate to オープン... from the Projucer's main menu.)
Opening PIP files
You may come across Projucerインスタント・プロジェクト (PIP) files when following other JUCE tutorials. These are essentially header files with the usual .h extension that provide metadata to the Projucer in order to automatically create a project with the correct modules and exporters from a single file.
PIP files can be opened similarly by either selecting the file from the オープン... dialog of the Projucer's main menu or a simple drag-and-drop onto the Projucer interface window.
概要
このチュートリアルを読めば、次のことができるようになるはずだ：
- JUCEをインストールする。
- Projucerを使って新しいプロジェクトを作成する。
- このプロジェクトをOSXのXcodeやWindowsのVisual StudioなどのネイティブIDEにエクスポートします。
- ターゲットとするプラットフォームのネイティブIDEでアプリをコンパイル、実行、デバッグする。
- 既存のプロジェクトとPIPファイルをProjucerで開きます。