Difference between revisions of "Activity Team/FAQ"

From Sugar Labs
Jump to navigation Jump to search
(add "How to package activity?")
Line 1: Line 1:
<noinclude>{{ GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Activity Team}}</noinclude>{{TOCright}}
+
<noinclude>{{TeamHeader|Activity Team}}{{TOCright}}
 +
[[Category:FAQ]]</noinclude>
 
: '''[[Talk:Activity Team/FAQ | Post questions here]]''' for the [[Activity Team]].
 
: '''[[Talk:Activity Team/FAQ | Post questions here]]''' for the [[Activity Team]].
 
=== About the Activity Team ===
 
=== About the Activity Team ===
Line 55: Line 56:
 
:Please refer to these pages for assistance in understanding the memory usage patterns of activities and the shell and for detecting leaks: http://wiki.laptop.org/go/MemoryUsageAnalysis and http://wiki.laptop.org/go/Memory_leak_testing
 
:Please refer to these pages for assistance in understanding the memory usage patterns of activities and the shell and for detecting leaks: http://wiki.laptop.org/go/MemoryUsageAnalysis and http://wiki.laptop.org/go/Memory_leak_testing
  
==== How to package activity? ====
+
==== How does one package an activity? ====
 
+
:Save the [http://git.sugarlabs.org/projects/hello-world/repos/mainline/blobs/master/setup.py setup.py] file in the top directory of your activity development tree. To make an activity bundle, run the following code:
:Place [http://git.sugarlabs.org/projects/hello-world/repos/mainline/blobs/master/setup.py setup.py] file to top directory of your activity, to make activity bundle run:
 
 
:<code>python setup.py dist_xo</code>
 
:<code>python setup.py dist_xo</code>
:output bundle will be placed to ''dist/'' subdirectory. See also [[Development_Team/Almanac/Activity_Bundles|Activity bundles specification]].
+
:An output bundle will be saved in the ''dist/'' subdirectory. See also [[Development Team/Almanac/Activity Bundles|Activity bundles specification]].
 
 
[[Category:FAQ]]
 

Revision as of 16:01, 2 November 2009

Team Home   ·   Join   ·   Contacts   ·   Resources   ·   FAQ   ·   Roadmap   ·   To Do   ·   Meetings

Post questions here for the Activity Team.

About the Activity Team

Who is on the Activity Team?

See Activity Team/Contacts for a list of team members.

How can I get in contact with you?

Feel free to write messages on our talk pages, or just drop in on one of our meetings.

Activity Development questions

What Sugar Labs author resources should I be aware of?

For new Activities:
Create a Gitorious project repository at http://git.sugarlabs.org/ and start hacking on your code! :-)
Request a trac component for your activity at http://dev.sugarlabs.org/
Open a trac ticket to request addition to Pootle our translation system (if your strings are mature)
Add your Activity to http://wiki.sugarlabs.org/go/Sugar_on_a_Stick/Roadmap if you want to be on the SoaS distro
If your Activity is migrating over from the OLPC infrastructure:
See How to migrate from OLPC.
When releasing an existing Activity:
If you have one, update your wiki page at http://wiki.sugarlabs.org/go/Activities/<actvity-name>
Upload your new .xo bundle, screenshots, notes to http://activities.sugarlabs.org/
Upload .bz2 source to shell.sugarlabs.org /upload/sugar/sources/honey (e.g., scp to download.sugarlabs.org:/srv/upload/sources ...)
Edit http://wiki.sugarlabs.org/go/Development_Team/Source_Code and make sure it's pointing to your latest .bz2

Where do I find information about implementing X in Sugar?

Check Activity Team/Resources for a comprehensive list of developer documentation, tutorials and support channels.

How do I get my activity to install an external dependency?

You don't! Activity bundles are supposed to be self-contained, and not depend on anything else other than the standard Sugar platform. If you need additional dependancies, you will need to include them within your activity bundle. If your additional dependancies are binary, please be aware Sugar can be run on different machine architectures.

I have a question about Git, or Gitorious.

See Activity Team/Git FAQ for a specific FAQ about Git and Gitorious.

How do I upload my new activity to the Activities Library?

The best guide is Activity Team/How_to_migrate_from_OLPC, since that's where activities are coming from. As the infrastructure stabilizes and we get more new activities, we will post a new page.

How do I get my activity in the hands of students?

The absolute best way to get your activity out into the world is to attend an [OLPC:Deployment_meetings OLPC deployment meeting] and suggest it to the deployment representatives. They can test your activity and offer feedback, and will ultimately decide whether it ships.
Another good way is to post and promote your activity on activities.sugarlabs.org. This will get your activity into the hands of the G1G1 community and can be a stepping stone to getting included in the Sugar on a Stick distribution and in OLPC deployments.

Help! I suddenly can't push to Gitorious!

The OSUOSL which hosts Gitorious has an aggressive IP blacklist policy. If you once were able to push but now cannot, send an email to support@osuosl.org requesting that your IP be removed from the blacklist.

Is there a Commits mailing list?

Instead of a commits list, we use the RSS feed at http://git.sugarlabs.org/events.atom. This tracks the activity (commits, branches, comments, merge requests) of all projects hosted on Gitorious.

How do I get a trac component associated with my project?

File a ticket with the request. Please assign the ticket to the trac component, mark it as a task and don't forget to mention the name of your project and the default owner for the tickets.

How do I analyze my activity's memory usage?

Please refer to these pages for assistance in understanding the memory usage patterns of activities and the shell and for detecting leaks: http://wiki.laptop.org/go/MemoryUsageAnalysis and http://wiki.laptop.org/go/Memory_leak_testing

How does one package an activity?

Save the setup.py file in the top directory of your activity development tree. To make an activity bundle, run the following code:
python setup.py dist_xo
An output bundle will be saved in the dist/ subdirectory. See also Activity bundles specification.