344
edits
Changes
Jump to navigation
Jump to search
Line 9:
Line 9: − Place your activity to ~/Activities/'''activity-name'''.activity directory.+ − + − + − + + + + + + + + + + + + + + + + + + + + + + + + Line 23:
Line 46: − + − + +
Activity Team/Getting Involved (view source)
Revision as of 08:56, 10 March 2010
, 08:56, 10 March 2010dev.sugarlabs.org -> bugs.sugarlabs.org
As an activity developer in most cases you need only [[Taxonomy#Glucose:_The_base_Sugar_environment|glucose]] module(its included to ''sugar-glucose'' or ''sugar'' packages).
As an activity developer in most cases you need only [[Taxonomy#Glucose:_The_base_Sugar_environment|glucose]] module(its included to ''sugar-glucose'' or ''sugar'' packages).
== If you want to create your own activity ==
To test your activity in sugar environment:
What you need to do to create or share your activity.
* use ''sugar'' command to run sugar as a regular window manager
* use ''sugar-emulator'' command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning.
==== Start coding ====
* '''Create''' an account on [http://git.sugarlabs.org git.sugarlabs.org] and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account].
* '''Create a new project''' (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in '''category "activities"'''.
* [[Activity_Team/Git_FAQ#How_do_I_create_a_new_project.3F|Initiate]] your project
* You can copy/paste [http://git.sugarlabs.org/projects/hello-world Hello World] activity to get an example of usual files hierarchy.
* Place your activity to ~/Activities/'''activity-name'''.activity directory.<br>To test your activity in sugar environment:
** use ''sugar'' command to run sugar as a regular window manager
** use ''sugar-emulator'' command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning.
* Consult with [[Activity Team/Resources]] to get useful links, [[Development Team/Almanac]] could be a good start page
* '''Start''' coding :)
==== Share your activity ====
If you want to share your activity for broad audience:
* Open a ticket on [https://bugs.sugarlabs.org bugs.sugarlabs.org] to create component for your activity e.g. {{bug|788}}
* Using ''setup.py'' from activity root directory, create .pot file
* '''Add''' the ''pootle'' user as a committer (from the "add committer" link on the mainline page) on [http://git.sugarlabs.org git.sugarlabs.org]
* Open a ticket on [https://bugs.sugarlabs.org bugs.sugarlabs.org] to add your activity to [http://translate.sugarlabs.org/ pootle](sugar translation environment) e.g. {{bug|810}}
* '''Upload a xo bundle'''(use ''setup.py'' to create bundle) to [http://activities.sugarlabs.org/ activities.sugarlabs.org].
** Be sure to include a couple of screenshots of your activity in action.
** [[Activity_Library/Glossary#Public_activity|Nominate]] your activity to the public
* Create activity page ''wiki.sugarlabs.org/go/Activities/<activity-name>''<br>keep in mind that page on [http://activities.sugarlabs.org/ activities.sugarlabs.org] targeted to users and page on wiki targeted to more experienced users and developers
==Join the Activity Team==
==Join the Activity Team==
# Copy your SSH public key into your User page.
# Copy your SSH public key into your User page.
# Add a link to your User page to [[Activity Team/Contacts]].
# Add a link to your User page to [[Activity Team/Contacts]].
# Send an email introducing yourself to sugar-devel@lists.sugarlabs.org.
# [http://lists.sugarlabs.org/listinfo/sugar-devel Subscribe], and send an email introducing yourself to sugar-devel@lists.sugarlabs.org.
If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org.
If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org.
==Quick Start==
==Help the Activity Team==
If you'd rather just start coding '''right now''', it's easy to do!
If you'd rather just start coding '''right now''', it's easy to do!