Android & iOS app for senseBox blockly

blockly cordova

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Thiemann96 b0765974c0 remove enable debug cuz not working yet		5 years ago
resources	update icon & splash, also for iOS	6 years ago
src	remove enable debug cuz not working yet	5 years ago
tools	CI: dont deploy releases to fdroid branch (#5 )	6 years ago
typings	initial project	6 years ago
.editorconfig	Initial commit	6 years ago
.gitignore	switch build commands to --prod	6 years ago
.gitmodules	blockly-wrap first try w/out save/delete button	6 years ago
.travis.yml	CI: build on node 6, fix release deploy	6 years ago
LICENSE	add LICENSE	6 years ago
README.md	update apk signing documentation	6 years ago
config.xml	added templater and template	5 years ago
ionic.config.json	rename app to "Blockly for senseBox"	6 years ago
package-lock.json	added templater and template	5 years ago
package.json	added templater and template	5 years ago
tsconfig.json	Initial commit	6 years ago
tslint.json	Initial commit	6 years ago

README.md

Blockly for senseBox app

Blockly for senseBox is a visual programming editor for the senseBox:edu on mobile. It is based on Google's Blockly and Carlos Pereira Atencio's Ardublockly.

Features

generate Arduino code with visual drag-and-drop blocks, with blocks for the senseBox platform.
online compiler for senseBox MCU
over the air programming via WiFi
Android 7+ & Web-browser support. (iOS support is upcoming)

Development

This is an Ionic 3 / Angular 5 application using Cordova Plugins for mobile-native functionality.

dev env setup

For a basic web version, only Node.js 8+ is required. For Android & iOS builds the respective platform tooling is required.

This repo contains mandatory submodules; so you need to clone this repo via

git clone --recursive https://github.com/sensebox/blockly-app.git

To install npm dependencies run npm install once.

Then run npm start to start a hot-reloading development view in the browser on http://localhost:8100.

Ionic & cordova provide CLIs for plugin installation & code generation. You might want to install them with npm install -g ionic cordova.

android specific

First install the Android toolchain on your system.

Make sure you have the correct environment variables set. On linux you could add this to your ~/.bashrc:

export ANDROID_SDK=$HOME/Android/Sdk
export ANDROID_HOME=$ANDROID_SDK
export PATH=$PATH:$ANDROID_SDK/emulator:$ANDROID_SDK/tools:$ANDROID_SDK/tools/bin:$ANDROID_SDK/platform-tools:$ANDROID_SDK/build-tools/28.0.3

To build & deploy on an emulator or device use the android:* build commands defined in package.json (some only work on linux), for example:

npm run android:dev # build debug build & deploy to connected device & restart app

release signing

You need a keystore with a valid signing key!

zipalign -p 4 blockly-unsigned.apk blockly-aligned.apk 
apksigner sign -ks reedu-android.keystore --in blockly-aligned.apk --out blockly-signed.apk

updating blockly

Blockly is included as a submodule, linking to https://github.com/sensebox/ardublockly-1. To update it, just pull in the commit you want, and commit the change in this repository:

cd src/assets/blockly
git pull
cd ../../..
git commit -m 'update blockly'

License

The source code in this repository is GPL-2 licensed. Submodules such as Blockly may be licensed differently, please check their respective repositories.