At SCADE, we are working on streamlining the installation over the next couple of versions. Thanks to all that provided valuable feedback. Please find the instructions below
All download links are included in the below instructions.
SCADE 1.0 is supporting the following versions
- Swift 3.0.x (Swift 3.1 support is coming mid April 2017)
- iOS 9.0 and greater
- Android 5.0 and greater
- OS requirement : Swift, and therefore SCADE, requires OSX version 10.10 or higher
- XCode 8.x is installed on the machine
- Android NDK R11c
- Android SDK 24.4.1 or higher
- CMake 3.1 or higher
- Gradle > 2-14.1 but < 3.0
- Java 8
- Harddisk space: You need about 800 MB of harddisk space
- Open terminal
- Install homebrew if you don't have it
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- Install wget
brew link makedepend
brew install wget
wget http://dl.google.com/android/repository/android-ndk-r11c-darwin-x86_64.zip -q - -show-progress
- Unzip in user directory
unzip -qq ./android-ndk-r11c-darwin-x86_64.zip -d ~/
Be patient, this is a big file and takes about 2 mins.
You should now find a directory
android-ndk-r11c in your user directory.
- Download sdk
wget https://dl.google.com/android/android-sdk_r24.4.1-macosx.zip -q - -show-progress
- Unzip sdk
unzip -qq ./android-sdk_r24.4.1-macosx.zip -d ~/
- Run Android SDK Manager using
Uncheck all default selections and choose
- Android 6.0 (API 23)
- Tools / Android SDK Build-tools version 23.0.2
- Extras / Android Support Repository
- Extras / Google Play Services
- Extras / Google Repository
Your selection windows should look like this
Now continue by pressing the Install 17 packages and accepting the licenses multiple times Finally, let's clear the android folder
- The .android folder. The .android folder that exists in the home directory of the user holdes settings that aren't needed and we want to start with clean slate.
- Delete the android folder using
sudo rm -Rf ~/.android
Gradle is our favourite build tool we use to build our Android and iOS app. If you are already using Gradle >= 2.14.1 and < 3.0 , you can skip this step.
Gradle can be installed in different locations. We use the local user directory
- Get Gradle using
wget https://services.gradle.org/distributions/gradle-2.14.1-all.zip -q - -show-progress
- Unzip Gradle using
unzip -qq ./gradle-2.14.1-all.zip -d ~/
- Export Gradle home using
- Edit bash using
- In the VI edtor, after making the modifications, use :wq! to save and quit (Press Escape, type :wq! and press Return)
- Exit the terminal and open new terminal session for the bash setting to become active
gradle -vto review your version Your output should look similar to this:
CMake is used to compile and build the Apple iOS software
brew install cmake
- You are done.
cmake -versionshould give you cmake message stating a version higher than 3.4.1
Especially if you have multiple versions of Xcode installed, its critical that you are using the correct version. Doublecheck using these commands
- swift -version
- xcrun swift -version
All these commands should point to Swift 3.0:
Support of Swift 3.1
We currently support 3.0.x only, not the Swift 3.1 version that comes with XCODE 8.3. However, we will support Swift 3.1 shortly. For now, you can still use SCADE by selecting the 3.0.2 toolchain instead of the 3.1 toolchain. Please see Using Swift 3.0.2
- Download SCADE here www.scade.io/download2
- The dmg file should now be in your Download folder (or similar folder)
- If your Mac did not automatically unzip the zip file, doubleclick to open the archive
- Scade.dmg becomes available in your folder
- Double click on Scade.dmg
- The Install dialog opens. Drag and drop Scade into the Applications folder
- Confirm that you want to overwrite any content
- Run SCADE from your applications directory
You find SCADE using Command + Space and searching for SCADE
or through your Applications Directory. Start it
- When you start SCADE for the very first time, you need to confirm this dialog
You will now be asked to provide a workspace folder. The workspace folder will contain the following assets:
- SCADE projects
- SCADE SDK and binary built during compilation process
Make sure that you use a NEW workspace you NEVER used before
Please use new workspace folder
If you have an old workspace folder, please don't use it. Instead use a new workspace folder. The old workspace contains upward incompatible settings files.
Choose a good workspace location
Please make sure that the workspace location you choose is OUTSIDE of the directory where SCADE resides. In this way, you can update the software without impacting your work.
The following settings make it possible to compile to iOS and Android. Without the settings, you will be able to develop and run on iOS, but not be able to compile.
Open the preferences settings
and configure the paths. When you press the apply button, we do check the validity of the path.
Here are the default directories from the above installation steps:
- You need to append /bin/gradle to the home directory path of Gradle
- The default Android SDK path on MAC is
Apple requires two different files for compiling apps
- a certificate file for signing the app, for instance cert.p12
- a mobile provision file prov.mobileprovisioning
You need to specify the location of these files in the build file of your app.
- Open the build file <YourApp>.build that can be found in the root directory of your project
- Scroll to the codeSignSettings section at the end of the file
- Modify the entries as shown below to reflect the location of your files
The certificate needs to be part of the keychain. Double click on it and make sure its part of your keychain:
Certificates can be password protected. Currently, we don't support password protected certificates, but will add this feature in the future.
In case you are using Swift 3.1 and want to use XCode 8.21 and Swift 3.0.2 as well, here are the instructions
Most likely your MAC self updated to XCode 8.3 and suddenly SCADE fails to run your programs. In that case, if you don't already have XCode 8.2.1 in a seperate install, download XCode 8.3.1 from the Apple website (Apple Developer program):
It's a BIG download of 4.x GB, so depending on network speed, this takes 15 mins...
Extract XCode 8.2.1. Big file of 4.x GB, extracting takes a few minutes
- Rename your XCode app, for instance to XCode 8.2.1
- IMPORTANT Move XCode 8.2.1 to Application folder
Point to XCode 8.2 in the XCode directory. In this installation, /Applications/XCode points to XCode 8.2.1
As your XCode now resides in another directory, you might have to adjust your build file and change the directories to point from /Applications/XCode to /Applications/XCode 8.2.1
What went wrong:
You did not use new workspace folder
How to fix:
Switch to new unused workspace folder