2,751
edits
Changes
Activity Team/Creating a New Activity (view source)
Revision as of 14:30, 30 August 2009
, 14:30, 30 August 2009add content from james simmons page
Add your Activity to http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Roadmap if you want to be on the SoaS distro
Add your Activity to http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Roadmap if you want to be on the SoaS distro
Do you have an idea for a new Activity you'd like to write but don't know how to begin? Here's some advice:
1). Don't try to write a Sugar Activity right away. Instead, write a standalone Python program that does what you want, then convert it to a Sugar Activity, being sure to keep a copy of the non-Sugarized version around for future use. There are several reasons for this, but the chief one is that standalone programs are easier to test, especially if you are not currently a Linux user. A standalone Python program can run anywhere, but a Sugar Activity really needs Sugar running on top of Linux. You can run your standalone Python program on an XO using the Terminal Activity.
When I add new features to my Sugar Activities I generally try to get the feature working on the standalone version first. I did this with text to speech in Read Etexts, for instance. This was useful because when I ran into problems I had a standalone app I could send to the speech-dispatcher mailing list so they could easily recreate my problem.
2). Sugar Activities are generally made with pygtk or pygame, and I believe pygtk is the more common of the two. These are both cross platform and have online tutorials, as does Python itself:
* http://www.python.org/
* http://www.pygtk.org/
* http://www.pygame.org/news.html
3). You'll want a good code-highlighting editor that understands Python. A couple of good ones:
* Eric: http://eric-ide.python-projects.org/eric4-download.html
* Gedit: http://projects.gnome.org/gedit/
These are a bit more complicated to install than typical Windows programs. They are included in every Linux distribution, though.
4). To make and test a Sugarized Activity you really should have a Linux distribution installed. The best for this purpose is probably Fedora 10, which includes the Sugar environment, eric, gedit, python, pygame, pygtk, a tool for making SVG icons, and lots of other useful stuff. You can run Linux on the same computer as Windows XP (by partitioning your hard drive, something the Fedora installer will do for you) and choose which one you want to run at boot time. Fedora 10 is no more difficult to install than Windows is, even if you want to run it and Windows on the same machine, and will run on hardware that would be inadequate for current versions of Windows. A Pentium III with 256 meg of RAM and a few gig of hard disk is more than adequate for Sugar development.
The Sugar environment that comes with Fedora 10 should be adequate for creating Activities. It is not the latest version of Sugar, but keep in mind that most XO laptops won't be running the latest Sugar either.
If you don't want to have anything to do with Linux you ''could'' make a standalone Python program and find a collaborator to Sugarize it for you. You could also attempt to develop your Activity using Sugar on a Stick, or an actual XO, but this would probably be more trouble than simply installing Fedora 10.
5). When you are ready to Sugarize your Python program, read these articles:
* http://wiki.sugarlabs.org/go/Development_Team/Almanac
* http://wiki.laptop.org/go/Beyond_Hello_World
Feel free to ignore any of this advice if it doesn't seem applicable. I hope that you'll find it gives you a place to start.
See also: [[Activity_Team/Resources]] , [[Modifying_Activities]] and [[Activities/Turtle_Art/Patching]]
==Additional tips and common "gotchas"==
* Don't use punctuation in your bundle_id, e.g. org.sugarlabs.my-activity-name is not a valid bundle name. Use CamelCase instead: org.sugarlabs.MyActivityName
* Follow the [http://wiki.laptop.org/go/Rainbow Rainbow] guidelines.
: On OLPC-XOs, you can test with Rainbow disabled by removing /etc/olpc-security
rm /etc/olpc-security
: Reënable Rainbow by touching /etc/olpc-security
touch /etc/olpc-security