SCADE

Installation on OSX

12th August 2018 - SCADE Version 0.9.8.1

Introduction - Up and running in 10 minutes

At SCADE, we are working on streamlining the installation over the next couple of versions. Thanks to all that provided valuable feedback. Given a fast internet connection, installation should not take longer than 10 minutes. Please find the instructions below

Lastest installation changes

  • In the latest release, nothing much changed. A great new features is our autoupdate functionality so that you can updates much more quickly.

Prerequisites

Supported versions

SCADE 1.0 is supporting the following versions

  • NEW Swift 4.1 on iOS, Swift 4.0.2 on Android
  • iOS X 10.13 and greater
  • Android 5.0 and greater

Requirements

  • OS requirement : Swift, and therefore SCADE, requires OSX version 10.13 or higher
  • XCode 9.3 including Swift 4.1 is installed on the machine
  • Android NDK R11c up to release 17. Release 18 support is coming in November
  • Android SDK 24.4.1 or higher
  • Java 8
  • Harddisk space: You need about 800 MB of harddisk space

Check for correct Java version

You require Java 8 and higher. You can do this using the java -version command from the command shell as below

Alternatively, use the settings dialog:

  1. Open System Preferences
  2. Open java

and check the version. You should have Java 1.8 and higher

In case you have Java version 6 or 7, you need to update.

Option I : From the command line, type
brew tap caskroom/versions
brew cask install java8

Option II : Please find download link for Java 8 here

Option II - If you cannot use homebrew, use Java download link

Step 1 - Install Android Studio

SCADE uses the following parts of Android Studio

  • the Android SDK
  • the Android NDK
  • (optionally) the Android Simulator to run Android binaries
    If you haven't previously installed Android Studio, we recommend to install it now.

  • Download and install Android Studio here https://developer.android.com/studio/#downloads

  • Start Android Studio, open any project or create new empty project
  • Select Tools → SDK Manager in the main menu
  • In the SDK Platforms tab, select the following components:
    • Android 6.0
  1. In the SDK Tools tab, select the followin components:
    • Android SDK Platform-Tools
    • Android SDK Tools
    • Google Play services
    • NDK
    • Support Repository / Google Repository
  1. Click Apply and wait for selected components to be installed

Results
Android SDK will be installed in the <UserHome>/Android/Library/sdk directory
Android NDK will be installed in the <UserHome>/Android/Library/sdk/ndk-bundle

Step 2 - Verify Swift and XCode Location

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 4.1

If this doesn't result in Swift 4.1 option, try setting the command line tools Command Line Tools Setup

Step 3 - Install SCADE

Download and extract SCADE from here

  1. Download SCADE here www.scade.io/download/
  2. If your Mac did not automatically unzip the zip file, doubleclick to open the archive
  3. Scade.dmg becomes available in your folder
  4. Double click on Scade.dmg
  5. The Install dialog opens. Drag and drop Scade into the Applications folder
  1. Confirm that you want to overwrite any content

Start Scade

  1. Run SCADE from your applications directory
    You find SCADE using Command + Space and searching for SCADE

or through your Applications Directory. Start it

  1. When you start SCADE for the very first time, you need to confirm this dialog

Choose Workspace

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

Choose a good workspace location

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.

Step 4 - Configure Android support

The following settings make it possible to compile to Android. Without the settings, you will be able to develop and run on iOS and in our SCADE simulator, but not be able to compile to Android.

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:

Software Location
Android NDK /Users/<Username>/Library/Android/sdk/ndk-bundle
Android SDK /Users/<Username>//Library/Android/sdk

Step 6 - Configure iOS support

The following settings make it possible to compile to iOS. Without the settings, you will be able to develop and run on iOS and in our SCADE simulator, but not be able to compile to iOS.

Configure files

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.

  1. Open the build file <YourApp>.build that can be found in the root directory of your project
  2. Scroll to the codeSignSettings section at the end of the file
  3. Modify the entries as shown below to reflect the location of your files

Make sure certificate is in keychain

The certificate needs to be part of the keychain. Double click on it and make sure its part of your keychain:

Certificates and password support

Certificates can be password protected. Currently, we don't support password protected certificates, but will add this feature in the future.

Set Command Line Tool option

Sometime the command line tools use the wrong version. Here the step to set command line tools to use Swift 3.1

  1. Run XCode 9.x
  2. Set Command Line Tools to use 9.1