SCADE

Installation on macOS

SCADE Version 2.0.0 BETA

Introduction - Up and running in about 10 minutes

SCADE 2.0 consists of the following components

  • a fully-native macOS IDE
  • the SCADE SDK for cross platform functionality (Graphics, controls, animation)
  • the SCADE Swift for Android compiler
  • the SCADE build manager

All these components are contained in the download and installed as one unit on your mac. It's easy, quick and simple.

Supported compilers and OSs in SCADE 2.0

System ComponentMin VersionMax Version
Swift Compiler on iOS5.3.x
Swift Compiler on Android5.3.x
iOS10.x
Android5.0

System Requirements

System ComponentMin VersionMax Version (inclusive)
macOS10.1511 (Big Sur)
XCode needs to be installed11.7. (you need to specify a 5.3 toolchain)12.4
Android Studio recommended: < 4.2.2
4.2.2 - testing is in progress
Android NDK needs to be installedR17
Android SDK needs to be installed24.4.1
Harddisk space800 MB
M1 SupportCurrently, you require Rosetta support. Native M1 Support is coming soon.https://support.apple.com/en-us/HT211861

Step 1 - Install and run SCADE 2.0 IDE

Download and extract SCADE from here

  1. Download SCADE here beta.scade.io/download/
  2. Double-click on the dmg file to install it

ā—ļø

Use Installation Directory without spaces

Currently, we have problems if the installation directory you install SCADE in contains spaces. Please choose a directory without spaces, otherwise SCADE will not compile. We are currently fixing this issue.

Start Scade

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

Open from Internet

When you start SCADE for the very first time, and receive the following error message, you need to doubleclick on the SCADE icon while pressing Control : Control + Doubleclick.
See here

šŸ“˜

Beta related steps

Please review Beta related steps in Step 4

Configure for XCode 12 users

SCADE works with XCode 12 without additional changes as long as you use the default XCode setup

Configure for XCode 11 users

if you use XCode 11, please make sure to set the Swift 5.3 toolchain in swift.toolchain

  1. Download Swift 5.3 toolchain from Apple here https://swift.org/builds/swift-5.3.3-release/xcode/swift-5.3.3-RELEASE/swift-5.3.3-RELEASE-osx.pkg
  2. Install the toolchain
  3. The toolchain will be installed in a directory under /Library/Developer/Toolchains/swift-5.3.3-RELEASE.xctoolchain
  4. You now need to tell SCADE to use this toolchain. Please set the swift.toolchain variable to /Library/Developer/Toolchains/swift-5.3.3-RELEASE.xctoolchain
  5. Goto SCADE > Preferences > Settings and modify the swift.toolchain setting:

See also Settings.yaml

Additional optional Information for your information - XCode and Swift Version

Swift VersionXCodeswift.toolchain setting
5.211.4+/Library/Developer/Toolchains/swift-5.3.3-RELEASE.xctoolchain
5.312.0, 12.1
5.3.112.2
5.3.212.3

Step 2 - Install Android Studio

SCADE uses the following parts of Android Studio

  • the Android SDK
  • the Android NDK
  • the Android Simulator to run Android applications
    If you haven't previously installed Android Studio, you must install it now.

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

Configure SDK

After installing Android Studio, please run the SDK setup to configure all the components we need for development

  1. From Android Studio, Select Tools ā†’ SDK Manager in the main menu
  1. In the SDK Platforms tab, select the following components:
    • Android 6.0
  1. In the SDK Tools tab, select the following 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

Install Simulator images

To run Android simulator, you have to download a simulator image. We suggest the following image

  • Pixel 4 - popular model and reference model from Google
  • 64 bit - all new Android apps need to be deployed as 64 Bit
  • Select Nougat 24 as the OS. This will allow you to run your app on very many Android devices. ABI 23 is also supported, but 24 has some updates that are very convenient.

You can use the Android AVD application or the command line to install the image. Our users / your colleagues told us they feel the command line is quicker and one is less likely to make errors. The install option using the AVD application can be found in the appendix here.

Install image from command line

  1. From the terminal, switch to the Android SDK directory (/Users/USERNAME/Library/Android/sdk/)

  2. Copy and execute the following command below to download above described image

./tools/bin/sdkmanager --install "system-images;android-24;google_apis;x86_64"

ā³ Be patient, downloading takes 5-8 minutes on average internet line. Its a 1.x GB large file!

  1. Copy and execute the following command below to create Pixel 4 ABI 24 x86 64Bit image
echo "no" | ./tools/bin/avdmanager --verbose create avd --force --name "Pixel4_ABI24_x86_64" --device "pixel" --package "system-images;android-24;google_apis;x86_64" --tag "google_apis" --abi "x86_64"

The result should look like this.

šŸ‘ Congratulations, you installed your Android Simulator !

Install Android NDK

SCADE supports Android NDK v17 and higher at the moment. We recommend using v21 due to some performance advantages during development time

  1. Download NDK here https://dl.google.com/android/repository/android-ndk-r21e-darwin-x86_64.zip
  2. Extract the NDK to a directory of your choice. I choose /Users/MYUSER/android-ndk-r21e
  3. We use /Users/scade/android-ndk-r21e in this example

šŸ§© Good job, important component was installed successfully.

Step 3 - Configure Android support

Now configure the SCADE settings. In the SCADE app, choose SCADE > Preferences > Settings. The settings file opens and you need to set directories paths from the above installation steps:

SoftwarePath
Android SDK/Users/USERNAME/Library/Android/sdk/
Android NDK/Users/USERNAME/opt/android-ndk-r21e

Please edit the Settings.yaml to set the paths to the SDK/NDK like this

See also Settings.yaml

šŸŽ‚ Almost done, just configure some beta related settings next.

Step 4 - Beta Related tasks

Enable use of unsigned components

The current version of SCADE includes unsigned components, resulting in many dialogs where you are asked to allow the use of that unsigned component. For the Beta, please disable the check by following these steps

  1. Disable check in terminal
    Open terminal and type : sudo spctl --master-disable

  2. Goto System Preferences > Security and enable Anywhere setting

Android NDK - Please use version 21

A small issue has been detected with the use of Android NDK 17. Please use 21 in the meantime.

End of Installation

Congratulations. Now your are ready for Cross Platform App Development with Swift on iOS and Android

Appendix

Install Android simulator using AVD Manager

These steps are optional and just in case you didn't like using the commandline option described above!

  1. Select AVD Manager
  1. Create new virtual device
    Press the new virtual device button
  1. Select Pixel 4 model
  1. Select System Image - Android OS version
  • Select the x86 Image Tab
  • From the list, select 64 bit Nougat

ā—ļø

Please make sure you select 64 bit

Users forget to select the x86 tab. Ensure you select the tab and select 64 bit

  1. Give Simulator an name

You successfully downloaded and installed an Android simulator

Updated 2 days ago

Installation on macOS


SCADE Version 2.0.0 BETA

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.