/sage-scratch

Primary LanguageActionScriptGNU General Public License v2.0GPL-2.0

Scratch 2.0 editor and player Build Status

This is the open source version of Scratch 2.0 and the core code for the official version found on http://scratch.mit.edu. This code has been released under the GPL version 2 license. Forks can be released under the GPL v2 or any later version of the GPL.

If you're interested in contributing to Scratch, please take a look at the issues on this repository. Two great ways of helping Scratch are by identifying bugs and documenting them as issues, or fixing issues and creating pull requests. When submitting pull requests please be patient -- the Scratch Team is very busy and it can take a while to find time to review them. The organization and class structures can't be radically changed without significant coordination and collaboration from the Scratch Team, so these types of changes should be avoided.

It's been said that the Scratch Team spends about one hour of design discussion for every pixel in Scratch, but some think that estimate is a little low. While we welcome suggestions for new features in our suggestions forum (especially ones that come with mockups), we are unlikely to accept PRs with new features that we haven't deeply thought through. Why? Because we have a strong belief in the value of keeping things simple for new users. To learn more about our design philosophy, see this forum post, or this paper.

Building

To build the Scratch 2.0 SWF you will need Ant, the Flex SDK version 4.10+, and playerglobal.swc files for Flash Player versions 10.2 and 11.4 added to the Flex SDK. Scratch is used in a multitude of settings and some users have older versions of Flash which we try to support (as far back as 10.2).

After downloading playerglobal11_4.swc and playerglobal10_2.swc, move them to <path to flex>/frameworks/libs/player/<version>/playerglobal.swc. E.g., playerglobal11_4.swc should be located at <path to flex>/frameworks/libs/player/11.4/playerglobal.swc.

The build.properties file sets the default location for the Flex SDK. Create a local.properties file to set the location on your filesystem. Your local.properties file may look something like this:

FLEX_HOME=/home/joe/downloads/flex_sdk_4.11

Now you can run Ant ('ant' from the commandline) to build the SWF.

If the source is building but the resulting .swf is producing runtime errors, your first course of action should be to download version 4.11 of the Flex SDK and try targeting that. The Apache foundation maintains an installer that lets you select a variety of versions. Newer versions of the SDK will build successfully but are known to cause runtime errors related to the flash.display3D.Context3D class.

Debugging

Here are a few integrated development environments available with Flash debugging support: