Developers manual: Difference between revisions

From OLPC
Jump to navigation Jump to search
m (Reverted edits by 89.212.226.165 (Talk) to last revision by Holt)
m (Reverted edits by Tonyguards (Talk) to last revision by Patrol)
 
(20 intermediate revisions by 12 users not shown)
Line 10: Line 10:
}}
}}


== Developing user software ==
<div style="margin: 20; padding-left: 30; padding: 10; border: black thin solid; background-color: #e0ffe0">This is a quick intro to working on activities for the XO, and other code for OLPC. Feel free to add to and update the manual; it is a work in progress.</div>


OLPC ships user-level software primarily produced by external communities. We do also contribute to their development, but our contributions go "upstream" through their community rather than our own.
This manual tries to provide you with the answers you need to get started either by contributing to existing projects or starting your own. Although it focuses on the software development side of the process, we are also very interested in encouraging [[Participate|other contributions]].

If you're looking to get involved in development of anything that the user sees, you should consult the developer documentation for the upstream project in question. For example, if you want to develop [[Sugar]] or a Sugar activity, see the [http://wiki.sugarlabs.org/go/Sugar_Labs/Getting_Involved#Developer Sugar developer resources]. For the GNOME platform or applications, refer to the [http://developer.gnome.org/ GNOME developer community].

== Developing at the system level ==

If you're interested in developing OLPC software at the system-level, the important backend stuff that the user doesn't really see, you can find documentation here.

OLPC builds upon Fedora as much as possible - meaning that many system-level developments would be more appropriately done within the [https://fedoraproject.org/wiki/Development Fedora developer community], which will then be automatically included in OLPC's software at a later date.


== Quickstart ==
== Quickstart ==
* Jim Simmons' [http://en.flossmanuals.net/ActivitiesGuideSugar/Introduction Make Your Own Sugar Activities!] <b>(NEW)</b>
* Sugar and Sugar Activity development is being hosted at [http://wiki.sugarlabs.org Sugar Labs]. You may want to consult the [http://wiki.sugarlabs.org/go/Activity_Team Activity Team] pages before you begin.
* See the [[Contributors_program|Contributors program]] page.
* See the [[Contributors_program|Contributors program]] page.
* Play with the OLPC environment (aka "Sugar"). Hopefully you've played with one yourself!
** You can [http://wiki.laptop.org/go/Emulating_the_XO/Quick_Start#Getting_started_with_QEMU emulate it too!]
* Get familiar with the Python language. Much OLPC development happens in Python.
* Get familiar with the Python language. Much OLPC development happens in Python.
** If you're familiar with other aspects of the [[Developers/Stack]], then you can focus on those aspects
** If you're familiar with other aspects of the [[Developers/Stack]], then you can focus on those aspects
* Set up [http://wiki.laptop.org/go/Sugar_with_sugar-jhbuild sugar-jhbuild] - this will likely be your primary development environment.
* Sign up for the [http://lists.laptop.org/listinfo/devel devel] [[mailing lists|mailing list]], become a lurker
* If you do [[IRC]], join #olpc on irc.freenode.net, and #olpc-devel on irc.oftc.net

* See [[Developers/Getting Started]] for some suggestions on how to find a project
* Sign up for the [http://lists.laptop.org/listinfo/devel devel] list, become a lurker
* If you do [[IRC]], join #olpc on irc.freenode.net


== Overview ==
== Overview ==
Line 31: Line 34:
** First steps: developer keys, getting connected with the community, finding a project, reporting bugs.
** First steps: developer keys, getting connected with the community, finding a project, reporting bugs.
* [[Developers/Setup]]
* [[Developers/Setup]]
** Indicates how you should configure your workstation for system-level OLPC development.
** Describes how to set up a [[Sugar]] development environment on your PC or workstation. It discusses emulation, running Sugar OS natively or in a virtual machine, cross compiling, and some configuration options. It also includes a discussion of which approach is likely to be the most appropriate for you
* [[Test Config Notes]]
* [[Test Config Notes]]
** If you have an XO, this page has many useful configuration tips for testing your application.
** If you have an XO, this page has many useful configuration tips for testing your application.
Line 51: Line 54:
== Release Schedule ==
== Release Schedule ==


See the [[Plan of Record-2008]] and [[Release Process Home]] for discussion of how OLPC presently makes releases.
See [[Release Process Home]] for discussion of how OLPC presently makes releases.


== Related docs and manuals ==
== Related docs and manuals ==
* [[Tutorials]]
* [[Tutorials]]
** [[PyGTK/Hello World Tutorial]]
** [[Beyond Hello World]]
*[[Developer/GettingStarted | Getting Started]]
* [http://wiki.sugarlabs.org/images/5/51/Activity_Handbook_200805_online.pdf Activity Handbook] -- a somewhat slower, more detailed tutorial-style
* [https://www6.software.ibm.com/developerworks/education/l-sugarpy/l-sugarpy-pdf.pdf Application Development for the OLPC Laptop] (Tim Jones, IBM developerWorks article)
* [[Activation_and_Developer_Keys|Instructions for getting a Developer Key]]
* [[Activation_and_Developer_Keys|Instructions for getting a Developer Key]]

* [[Sugar_almanac | The Sugar Almanac]] -- Start here for API use tips
[[Category:Developers]]
[[Category:Developers]]
[[Category:Software development]]
[[Category:Software development]]

Latest revision as of 15:01, 25 October 2012

  english | 한국어español HowTo [ID# 276303]  +/-  



Developing user software

OLPC ships user-level software primarily produced by external communities. We do also contribute to their development, but our contributions go "upstream" through their community rather than our own.

If you're looking to get involved in development of anything that the user sees, you should consult the developer documentation for the upstream project in question. For example, if you want to develop Sugar or a Sugar activity, see the Sugar developer resources. For the GNOME platform or applications, refer to the GNOME developer community.

Developing at the system level

If you're interested in developing OLPC software at the system-level, the important backend stuff that the user doesn't really see, you can find documentation here.

OLPC builds upon Fedora as much as possible - meaning that many system-level developments would be more appropriately done within the Fedora developer community, which will then be automatically included in OLPC's software at a later date.

Quickstart

  • See the Contributors program page.
  • Get familiar with the Python language. Much OLPC development happens in Python.
    • If you're familiar with other aspects of the Developers/Stack, then you can focus on those aspects
  • Sign up for the devel mailing list, become a lurker
  • If you do IRC, join #olpc on irc.freenode.net, and #olpc-devel on irc.oftc.net
  • See Developers/Getting Started for some suggestions on how to find a project

Overview

  • Developers/Getting Started
    • First steps: developer keys, getting connected with the community, finding a project, reporting bugs.
  • Developers/Setup
    • Indicates how you should configure your workstation for system-level OLPC development.
  • Test Config Notes
    • If you have an XO, this page has many useful configuration tips for testing your application.
  • Developers/Stack
    • Describes the choices of programming languages and "software stacks" for developing code on the OLPC. It details the base stack of hardware, firmware, operating system and the Sugar environment. It then gives options for programming in Python, Squeak, C/C++ and other languages or activities.
  • Developers/Issues
    • Describes the special considerations required for working on the OLPC project, particularly those driven by our target hardware and deployment environments
  • Developers/Projects
    • Suggests ways to choose a particular project, whether one that already exists, or one of your own, and how to start working on the project once you have chosen it
  • Developers/Communication
    • Describes the various support and communications channels used by the project, including how to get help with problems, and how to set up your own per-project communications channels
  • Developers/Documentation
    • Collects pointers to the various sources of documentation available for the project. Helping us better document our code is always a welcome contribution.
  • Developers/FAQ
    • Collects and attempts to answer common questions that developers have when working on the Sugar platform
  • Developers/Fedora
    • Discusses how to join the Fedora development community on top of which OLPC is based.

Release Schedule

See Release Process Home for discussion of how OLPC presently makes releases.

Related docs and manuals