| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
starting_from_scratch_with_the_projucer [2017/08/28 20:54]
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 ===== | |
| |
| 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|}} | |
| |
| |
| |
| |
