| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
starting_from_scratch_with_the_projucer [2017/08/28 21:23]
shane [Downloading and installing JUCE] |
— (current) |
| ====== Starting from scratch with the Projucer ====== | |
| The JUCE Projucer is a code and IDE-project generator. You specify what kind of project you want (e.g. GUI application, Audio Plug-In, etc.), and the target IDEs you intend to work with (e.g. Visual Studio, XCode), plus some other details such as a project name, and the Projucer will generate a complete project/solution for each IDE, including a few "starter" code files. You can then open each project/solution in the appropriate IDE, click on "Build" and within a few minutes have a working app or plugin for your target platform. | |
| |
| Well, that's the theory. In practice, there are lots of little details to understand, which can be overwhelming when you're just getting started. On this page I'll take you step-by-step through building a synthesizer plugin for Windows (VST v2.4) and Macintosh (AU v2). | |
| |
| ===== Downloading and installing JUCE ===== | |
| If you haven't already installed JUCE, go to https://www.juce.com and hit the "Get JUCE" button at the top of the page. This will take you to an information page that explains Roli's licensing options, with "download" and "purchase plan" links for the various choices. If you're just beginning to explore JUCE, you can simply choose the "download" link at the bottom of the "Personal/Free" column, which takes you straight to the Downloads page. Click the appropriate button for the platform you'll be starting out on: Mac, Windows, or Linux. These instructions were prepared using Windows, but the other platforms will be very similar. | |
| |
| All three download buttons will put a ''.zip'' file into your Downloads directory, the contents of which differ only very slightly from one platform to the next. I did my downloading in August, 2017, shortly after the release of JUCE "Huckleberry" version 5.1; if you're reading this page much later, there might be a newer JUCE release with slight differences from what's shown below, but the basic structure is likely to be the same. | |
| |
| When I opened up the file ''juce-huckleberry-windows.zip'' (I used [[http://www.7-zip.org/|7-Zip]], but any other archive manager, including the default one built into Windows, will look about the same), I saw that the zip file contained exactly one folder, called ''JUCE'', whose contents look like this: | |
| |
| {{::juce-zip-contents.png?nolink|}} | |
| |
| You can unzip this ''JUCE'' folder wherever you wish, but the default location is in your user directory. On my Windows PC, which has several drives, I put it in ''D:\Documents\VST Development\JUCE''. As you'll see shortly, the Projucer allows you to specify wherever you decide to put it. | |
| |
| ===== Running the Projucer for the first time ===== | |
| |
| The very first time you run the Projucer | |
| ===== Running the Projucer for the first time ===== | |
| |
| Wherever you decide to put the ''JUCE'' folder on your system, navigate to it and you'll see the icon for ''Projucer.exe'' (it will be called simply "Projucer" on Mac or Linux), which you double-click to open the Projucer application. | |
| |
| The first thing you'll see, when you run the Projucer for the very first time, is the "Create New Project" page, shown below. On subsequent runs, you'll most commonly see the last ''.jucer'' project you had open, which the Projucer remembers. To create a new project, go to the Projucer's File menu and close whatever project is open, then choose "New Project..." | |
| |
| {{::projucer-new-project.png?direct&600|}} | |
| |
| The Create New Project page has eight large graphic buttons for the eight most common project types. Click the button labeled "Audio Plug-In", which I have outlined in red in the screen shot above. This will take you to the "second half" of the Create New Project page, as shown below. (Note the two pink circles at the bottom of the screen shot; these indicate that the page has two parts, and you can go back and forth between them by clicking on the circles. The filled circle indicates the currently-shown part.) | |
| |
| {{::projucer-new-project-2.png?direct&600|}} | |
| |
| The first time you try the Projucer, when you haven't a clue what any of this means, it can be a little daunting, but it's actually straightforward: | |
| * Start by using the large folder-navigation box on the left (it works just like an Explorer/Finder window) to choose the folder //in which you want your new project's folder to be created//. | |
| * The label "Project Folder" is a little confusing; I started by creating a new folder for my new project and selecting that, and ended up with a folder called "VanillaJuce" inside another folder called "VanillaJuce". | |
| * What you want to see in the combo box just under the label "Project Folder" is actually the path to your "project__s__ folder". The Projucer will create a new folder for your new project inside this one. | |
| * After selecting your projects folder, go to the "Project Name" field at the top left, and type the name of your new project, in my case "VanillaJuce". | |
| * Whatever you type will automatically appear in the "Folder" field at the bottom left, i.e., the default name for your new project's folder is the same as the name you choose for your project. If you want a different folder name (but no change to the project name), you can type something different in the "Folder" field. | |
| * You can ignore the "Files to Auto-Generate" item at the top right; it isn't used for Audio Plugin projects. | |
| |
| |
| |
