scratchfoundation/scratchjr
1
0
Fork 0
mirror of https://github.com/scratchfoundation/scratchjr.git synced 2024-11-25 00:28:20 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
With ScratchJr, young children (ages 5-7) can program their own interactive stories and games.
211 commits 73 branches 4 tags 34 MiB
JavaScript 67.1%
Java 11.8%
CSS 9.7%
Objective-C 7.3%
HTML 3.9%
Other 0.2%
Find a file
Vuton Design ec0e28bbda Clean-Up
2017-09-25 12:29:09 +01:00
.tx Add languages 2017-09-16 14:33:28 -04:00
android Reduced sound effects to 16-bit for Android compatibility 2017-03-13 13:56:02 -04:00
bin Updating bundle-compile.sh and adding gradle task 2016-02-03 14:13:32 -05:00
doc Initial commit 2016-01-08 14:31:04 -05:00
editions/free Add languages 2017-09-16 14:33:28 -04:00
ios Update to xcode recommended settings 2017-08-14 16:27:07 -04:00
src Add languages 2017-09-16 14:33:28 -04:00
.eslintignore Ignore linting for bundles 2016-01-21 15:37:55 -05:00
.eslintrc Asynchronous loading of MediaLib 2016-01-22 16:19:51 -05:00
.gitignore Updating .gitignore 2016-05-02 11:05:08 -04:00
CONTRIBUTING.md Clean-Up 2017-09-25 12:29:09 +01:00
LICENSE Add license and trademark. Update package.json author information. Resolves GH-473 2016-05-18 04:58:44 -07:00
package.json Add license and trademark. Update package.json author information. Resolves GH-473 2016-05-18 04:58:44 -07:00
README.md Clean-Up 2017-09-25 12:24:45 +01:00
TRADEMARK Add license and trademark. Update package.json author information. Resolves GH-473 2016-05-18 04:58:44 -07:00
webpack.config.js Merge entry-points and bundles for editor, home, index 2016-01-22 16:20:18 -05:00

README.md

Overview

This is the official git repository hosting the source code for the ScratchJr project.

ScratchJr can be built both for iOS and Android. A pure-web version or Chrome-app version is planned to follow at some point in the future.

Platform Status
iOS Released in App Store
Android Released on Google Play and Amazon store

Release Schedule

As of this writing, the Android version now supports Android 4.2 and above.

Architecture Overview

The diagram below illustrates the architecture of ScratchJr and how the iOS (functional), Android (functional) and pure HTML5 (future) versions share a common client.

Scratch Jr. Architecture Diagram

Directory Structure and Projects

This repository has the following directory structure:

  • src/ - Shared JavaScript code for iOS and Android common client. This is where most changes should be made for features, bug fixes, UI, etc.
  • editions/ - Assembly directories for each "flavor" of ScratchJr. These symlink to src for common code, and could diverge in settings and assets.
    • free/ - Free edition JavaScript, including all shared code for all releases
  • android/ - Android port of Scratch Jr. (Java, Android Studio Projects)
    • ScratchJr/ - Android Studio Project for ScratchJr Android Application
  • bin/ - Build scripts and other executables
  • doc/ - Developer Documentation
  • ios/ - XCode project for iOS build. (Make sure to open ScratchJr.xcworkspace not ScratchJr.xcodeproj)

Building ScratchJr

To build the Android version, you need to have a system equipped with Android Studio. To build the iOS version, you need to have a Mac with XCode.

Ensure you have node and npm installed.

With all of the code checked out, you must install npm dependencies for bundling the JavaScript:

  • npm install

The build caches .png files out of the .svg files to improve performance. To enable this build step, you need to install a few dependencies.

On Ubuntu:

  • Run sudo easy_install pysvg to install python svg libraries
  • Run sudo apt-get install librsvg2-bin to install rsvg-convert
  • Run sudo apt-get install imagemagick to install ImageMagick

On OS X:

  • Install Homebrew.
  • Run sudo easy_install pysvg to install python svg libraries
  • Run brew install librsvg to install rsvg-convert
  • Run brew install imagemagick to install ImageMagick

Once these are installed, select the appropriate target in XCode or the appropriate flavor/build variant in Android Studio. To build in Android Studio, open the project android/ScratchJr. To build for iOS in XCode, open ios/ScratchJr.xcworkspace as ScratchJr uses CocoaPods.

Where and how to make changes

All changes should be made in a fork. Before making a pull request, ensure all changes pass our linter:

  • npm run lint

For more information, see CONTRIBUTING.md.

Code credits

ScratchJr would not be possible without free and open source libraries, including:

Acknowledgments

ScratchJr is a collaborative effort between: