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 Component

Min Version

Max Version

Swift Compiler on iOS

5.3.x

5.4

Swift Compiler on Android

5.3.x

5.4

iOS

10.x

Android

5.0

System Requirements

System Component

Min Version

Max Version (inclusive)

macOS

10.15

11 (Big Sur)
macOS Monterey is currently NOT supported. We are working on support

XCode needs to be installed

12.4 (Recommended)

13.0 (In Progress) (Some features might not be working)

Android Studio

4.3.0

4.3.0

Android NDK needs to be installed

R17

Android SDK needs to be installed

24.4.1

Harddisk space

800 MB

M1 Support

Currently, 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.

Enable Rosetta on mac M1

SCADE currently is compiled for the Intel CPU family (we are actively working on M1 support) and requires Rosetta to run on the Apple M1 cpu.

Please enable Rosetta as shown below on your M1 macs

Select App and click "Get Info"

Check Rosetta "Open using Rosetta"

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

Overview Swift Version and XCode

Swift Version

XCode

swift.toolchain setting

5.2

11.4+

/Library/Developer/Toolchains/swift-5.3.3-RELEASE.xctoolchain

5.3

12.0, 12.1

5.3.1

12.2

5.3.2

12.3

5.4

12.4

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

Version

Status

Download

Android Studio 4.3.0

Recommended

Link

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:

Software

Path

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