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.
|System Component||Min Version||Max Version|
|Swift Compiler on iOS||5.3.x|
|Swift Compiler on Android||5.3.x|
|System Component||Min Version||Max Version (inclusive)|
|macOS||10.15||11 (Big Sur)|
|XCode needs to be installed||11.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 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|
- Download SCADE here beta.scade.io/download/
- 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.
Run SCADE from your applications directory. You can also find SCADE using Command + Space and searching for SCADE
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.
Beta related steps
Please review Beta related steps in Step 4
SCADE works with XCode 12 without additional changes as long as you use the default XCode setup
if you use XCode 11, please make sure to set the Swift 5.3 toolchain in swift.toolchain
- 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
- Install the toolchain
- The toolchain will be installed in a directory under /Library/Developer/Toolchains/swift-5.3.3-RELEASE.xctoolchain
- 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
- Goto SCADE > Preferences > Settings and modify the swift.toolchain setting:
See also Settings.yaml
|Swift Version||XCode||swift.toolchain setting|
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
After installing Android Studio, please run the SDK setup to configure all the components we need for development
- From Android Studio, Select Tools → SDK Manager in the main menu
- In the SDK Platforms tab, select the following components:
- Android 6.0
- In the SDK Tools tab, select the following components:
- Android SDK Platform-Tools
- Android SDK Tools
- Google Play services
- Support Repository / Google Repository
- Click Apply and wait for selected components to be installed
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.
From the terminal, switch to the Android SDK directory (/Users/USERNAME/Library/Android/sdk/)
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!
- 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 !
SCADE supports Android NDK v17 and higher at the moment. We recommend using v21 due to some performance advantages during development time
- Download NDK here https://dl.google.com/android/repository/android-ndk-r21e-darwin-x86_64.zip
- Extract the NDK to a directory of your choice. I choose /Users/MYUSER/android-ndk-r21e
- We use /Users/scade/android-ndk-r21e in this example
🧩 Good job, important component was installed successfully.
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:
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.
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
Disable check in terminal
Open terminal and type : sudo spctl --master-disable
Goto System Preferences > Security and enable Anywhere setting
A small issue has been detected with the use of Android NDK 17. Please use 21 in the meantime.
Congratulations. Now your are ready for Cross Platform App Development with Swift on iOS and Android
These steps are optional and just in case you didn't like using the commandline option described above!
- Select AVD Manager
- Create new virtual device
Press the new virtual device button
- Select Pixel 4 model
- 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
- Give Simulator an name
You successfully downloaded and installed an Android simulator
Updated 2 days ago