opensensemap
/
blockly-app
mirror of https://github.com/sensebox/blockly-app
1
0
Fork 0
Code Issues Releases Wiki Activity
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.
ft_eric_networkscanner
development
master
ios
gh-pages-archive
v1.1.4
v1.1.3
v1.1.2
v1.1.1
v1.1.0
v1.0.1
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'ft_eric_networkscanner'
${ noResults }
blockly-app/README.md

3.2 KiB
Raw Permalink Blame History

Blockly for senseBox app Build Status Fdroid Badge github releases

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.