Installation on macOS

SCADE Version 2.0.54 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 Build Manager
  • SCADE IDE Settings Validation
  • SCADE Theme Manager
  • the SCADE Swift for Android compiler
  • Running Android Emulators from the SCADE IDE, and other Android Builds and installing Fixes
  • Setting Minimum and Maximum Sizes for Widgets in the Grid Layout
  • Copying content of SVG Images from clipboard and pasting them to any Widget in the SCADE IDE

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 Version
Swift Compiler on iOS5.3.x
Swift Compiler on Android5.3.x
iOS10.x
Android5.0

System Requirements

System ComponentLink to download
macOS (Intel, M1)
XCode needs to be installedhttps://xcodereleases.com/
Android Studiohttps://developer.android.com/studio
Android NDK needs to be installedR22
https://github.com/android/ndk/wiki/Unsupported-Downloads

(Download .zip file)
Android SDK needs to be installed

The installation of SCADE simply involves two steps:

Step 1 - Install and run SCADE 2.0 IDE

Download and extract SCADE from here

  1. Download the latest SCADE version by clicking here beta.scade.io/download/
  2. Double-click on the downloaded dmg file to install it in your Applications directory

❗️

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

📘

Beta related steps

Please review Beta related steps in Step 4

Step 2 - Platform Configuration

The macOS operating system supports the development of SCADE apps for both iOS and Android mobile devices. Notably, you will need to complete at least one of the platform configuration steps given below to build and run your SCADE projects successfully:

Xcode Configuration

SCADE is highly compatible with the latest Xcode. SCADE runs smoothly on the iOS platform just by using the default Xcode setup with no additional dependencies needed for its execution.

Android Configuration

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

VersionStatusDownload
Android Studio Bumblebee (2021.1.1) Patch 2Recommended Mac (Intel)

Mac (Apple Silicon)

Configuring Android SDK

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

  1. From Android Studio, Select the vertical ellipsis icon at the top-right corner to have access to the SDK Manager
25602560
  1. In the SDK Platforms tab, select the following components:
    • Android 7.0
20242024
  1. In the SDK Tools tab, select the following components:
    • Android SDK Platform-Tools
    • Android SDK Build-Tools
    • Google Play services
    • Google Play Licensing Library
20242024
  1. Click Apply and wait for selected components to be installed

Set up the Android Emulator

To run the Android emulator, you have to create a virtual device and download a system image.

We recommend the following to achieve the aforementioned:

  • 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 Operating System. This will allow you to run your app on a very large number of Android devices. API 23 is also supported, but API 24 has some updates that are very convenient.

Follow these steps to create an Android emulator:

  1. Click the vertical ellipsis icon at the top-right corner of your Android Studio to select the Virtual Device Manager and setup the Android emulator of your choice.
25602560
  1. On the Virtual Device Manager page, press the Create Device button to select a device definition.

  2. Select the Pixel 4 model and click on Next.

22242224
  1. Download and select the Nougat API level 24 system image. Then press Next.
22242224
  1. Assign a name to your newly created Android Virtual Device.
22242224

👍 Congratulations, you have successfully downloaded and installed your Android emulator!

Install Android NDK

The installed Android emulator needs this component before projects may successfully build and run in the IDE. SCADE currently supports Android NDK v17+. 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 convenient directory. I choose /Users//android-ndk-r21e
  3. Enter the command below in your terminal to prevent permission errors with the NDK.
sudo xattr -cr /Users/<myuser>/android-ndk-r21e
  1. We use /Users/olanrewajuolakunle/Documents/android-ndk-r21e in this example1

🧩 Good job, an important component has been installed successfully.

Configure Android support

Now configure the SCADE settings. In the menubar at the top-left corner of your SCADE app, choose Scade > Preferences > Settings 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

27842784

See also Settings.yaml

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 you are ready for Cross Platform App Development with Swift on iOS and Android