Community Repository

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(How to release packages: Paste section from the Installer page)
(Rewrite the page)
Line 1: Line 1:
= Community Repository =
+
The community repository is the place where independent Neo application developers can release projects. It is a similar concept to the Multiverse repository in Ubuntu. The Repository is at:
There is a community repository that every one can release your projects on Neo.
+
  
= Sites =
+
http://downloads.openmoko.org/repository/Multiverse
The Repository: http://downloads.openmoko.org/repository/Multiverse
+
  
The mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository
 
  
= How to release packages =  
+
== How to use the repository ? ==
  
Sharing applications is done by uploading packages to the [http://downloads.openmoko.org/repository/Multiverse/ Community Repository], which is a similar concept to the Multiverse repository in Ubuntu.  [[CommunityRepository|Anyone can upload applications]] or even their own repository to share with fellow Neo owners.
+
This repository is already installed by default in [[Om2008.8 | Om 2008.8]].
You can release your package with ipk file.  
+
  
* [[Create package on projects.openmoko.org and upload]]
+
Otherwise, see instructions on the [http://wiki.openmoko.org/wiki/Om_2008.8_Installer installer page]. They involve creating a one line file in the /etc/opkg directory.
* how to create ipk files
+
** Using OE
+
** [[Toolchain|Meta-toolchain]]
+
  
 +
== How to release packages ? ==
  
===How to add a package to Openmoko Repository===
+
Please use the mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository .
 +
The package manager derives from [[opkg]], so applications should be released as .ipk files.
  
 +
* [[Create package on projects.openmoko.org and upload]]
 +
* Here are [http://handhelds.org/moin/moin.cgi/BuildingIpkgs| instructions to build ipkgs].
 +
** Using OE
 +
** [[Toolchain|Meta-toolchain]]
  
==== Package Tags ====
 
 
Packages in '''Installer''' are displayed according to '''Package Tags'''.
 
Packages in '''Installer''' are displayed according to '''Package Tags'''.
 
To display a package through [[Om2008.8_Installer |Installer]], add the appropriate tag message.  
 
To display a package through [[Om2008.8_Installer |Installer]], add the appropriate tag message.  
Line 41: Line 39:
 
|Repos          || group::repos
 
|Repos          || group::repos
 
|}
 
|}
 
  
 
* For OpenEmbedded users, add a Tag by adding one line in your bb file
 
* For OpenEmbedded users, add a Tag by adding one line in your bb file
Line 47: Line 44:
 
  PKG_TAGS_${PN} = "group::games"
 
  PKG_TAGS_${PN} = "group::games"
  
= How to create your own repository =
 
TBD
 
  
== Package Tags ==
+
== Packages quality control ==
If you want your package to be shown on [[Om2008.8_Installer |Installer]], please add tag message on your package.
+
{|
+
! Category !! Tag
+
|-
+
| Communication || group::communication
+
|-
+
| Development  || group::programming
+
|-
+
| Games        || group::games
+
|-
+
| Maps          || group::maps
+
|-
+
| Miscellaneous || group::unknown
+
|-
+
| Network      || group::network
+
|-
+
|Repos          || group::repos
+
|}
+
  
* For OE user, please adding the Tag by adding one line in your bb file
+
The reviewer will check if there have new packages on the mailing list. If you are reviewer and want to review that package
For [http://code.google.com/p/comic-reader/source/browse/trunk/data/comic-reader_svn.bb example]:
+
* reply that mail, and say you want to review that
PKG_TAGS_${PN} = "group::games"
+
* check if the package follows the policy
 +
* download the package on projects.openmoko.org
 +
* install that package to see if
 +
** installable?
 +
** executable able?
 +
** functions the claimed works actually works?
 +
** If it do something bad?
 +
** uninstall it and see if everything still ok?
 +
* if the package is okay, put the package in this [https://svn.openmoko.org/trunk/feeds/community-repository/file-index.txt file] and the package will shown next day.
  
== Adding the community repository to the package manager ==
+
Good packages should conform to these quality guidelines:
  
The community-repository is already installed by default in [[Om2008.8 | Om 2008.8]]. Otherwise, see instructions on the [http://wiki.openmoko.org/wiki/Om_2008.8_Installer installer page].
+
* Packages in this repository shall not be in OM Official repositories
 +
* Program shall not collect user information and send to others unless it has very clear notification
 +
* Program shall not destroy the system
 +
* All packages shall be run-able on Neo
 +
* The package file name should refer which version of the project is compiled.
  
= We need your help =
+
== How to contribute ? ==
We need reviewers who can review new packages. If you want to help, please send e-mail to the mailing list ''community-repository@lists.openmoko.org
+
''.
+
  
 +
We need reviewers who can review new packages. This is currently a low workload. If you want to help, please send e-mail to the mailing list The mailing list: [http://lists.openmoko.org/mailman/listinfo/community-repository community-repository@lists.openmoko.org].
  
 
Reviewers must have the following:
 
Reviewers must have the following:
Line 93: Line 81:
 
   [http://wiki.openmoko.org/wiki/User_talk:Tick Tick]
 
   [http://wiki.openmoko.org/wiki/User_talk:Tick Tick]
  
== Review Packages ==
+
== How to create your own repository ? ==
The reviewer will check if there have new packages on the mailing list. If you are reviewer and want to review that package
+
* reply that mail, and say you want to review that
+
* check if the package follows the policy
+
* download the package on projects.openmoko.org
+
* install that package to see if
+
** installable?
+
** executable able?
+
** functions the claimed works actually works?
+
** If it do something bad?
+
** uninstall it and see if everything still ok?
+
* if the package is okay, put the package in this [https://svn.openmoko.org/trunk/feeds/community-repository/file-index.txt file] and the package will shown next day.
+
 
+
=== Review Policy ===
+
* Packages in this repository shall not in OM Official repositories
+
* Program shall not collect user information and send to others unless it has very clear notification
+
* Program shall not destroy the system
+
* All packages shall be run-able on Neo
+
* The package file name should refer which version of the project is compiled.
+
  
 +
TBD
  
 
[[category:Documentation]]
 
[[category:Documentation]]
 
[[category:Community]]
 
[[category:Community]]

Revision as of 15:53, 1 September 2008

The community repository is the place where independent Neo application developers can release projects. It is a similar concept to the Multiverse repository in Ubuntu. The Repository is at:

http://downloads.openmoko.org/repository/Multiverse


Contents

How to use the repository ?

This repository is already installed by default in Om 2008.8.

Otherwise, see instructions on the installer page. They involve creating a one line file in the /etc/opkg directory.

How to release packages ?

Please use the mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository . The package manager derives from opkg, so applications should be released as .ipk files.

Packages in Installer are displayed according to Package Tags. To display a package through Installer, add the appropriate tag message.

Category Tag
Communication group::communication
Development group::programming
Games group::games
Maps group::maps
Miscellaneous group::unknown
Network group::network
Repos group::repos
  • For OpenEmbedded users, add a Tag by adding one line in your bb file
For example:
PKG_TAGS_${PN} = "group::games"


Packages quality control

The reviewer will check if there have new packages on the mailing list. If you are reviewer and want to review that package

  • reply that mail, and say you want to review that
  • check if the package follows the policy
  • download the package on projects.openmoko.org
  • install that package to see if
    • installable?
    • executable able?
    • functions the claimed works actually works?
    • If it do something bad?
    • uninstall it and see if everything still ok?
  • if the package is okay, put the package in this file and the package will shown next day.

Good packages should conform to these quality guidelines:

  • Packages in this repository shall not be in OM Official repositories
  • Program shall not collect user information and send to others unless it has very clear notification
  • Program shall not destroy the system
  • All packages shall be run-able on Neo
  • The package file name should refer which version of the project is compiled.

How to contribute ?

We need reviewers who can review new packages. This is currently a low workload. If you want to help, please send e-mail to the mailing list The mailing list: community-repository@lists.openmoko.org.

Reviewers must have the following:

  • an account on projects.openmoko.org
  • ssh public key on projects.openmoko.org
  • basic svn skills
  • basic opkg skills

Openmoko really appreciates your help!

 Current Reviewers
 Tick

How to create your own repository ?

TBD

Personal tools

The community repository is the place where independent Neo application developers can release projects. It is a similar concept to the Multiverse repository in Ubuntu. The Repository is at:

http://downloads.openmoko.org/repository/Multiverse


How to use the repository ?

This repository is already installed by default in Om 2008.8.

Otherwise, see instructions on the installer page. They involve creating a one line file in the /etc/opkg directory.

How to release packages ?

Please use the mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository . The package manager derives from opkg, so applications should be released as .ipk files.

Packages in Installer are displayed according to Package Tags. To display a package through Installer, add the appropriate tag message.

Category Tag
Communication group::communication
Development group::programming
Games group::games
Maps group::maps
Miscellaneous group::unknown
Network group::network
Repos group::repos
  • For OpenEmbedded users, add a Tag by adding one line in your bb file
For example:
PKG_TAGS_${PN} = "group::games"


Packages quality control

The reviewer will check if there have new packages on the mailing list. If you are reviewer and want to review that package

  • reply that mail, and say you want to review that
  • check if the package follows the policy
  • download the package on projects.openmoko.org
  • install that package to see if
    • installable?
    • executable able?
    • functions the claimed works actually works?
    • If it do something bad?
    • uninstall it and see if everything still ok?
  • if the package is okay, put the package in this file and the package will shown next day.

Good packages should conform to these quality guidelines:

  • Packages in this repository shall not be in OM Official repositories
  • Program shall not collect user information and send to others unless it has very clear notification
  • Program shall not destroy the system
  • All packages shall be run-able on Neo
  • The package file name should refer which version of the project is compiled.

How to contribute ?

We need reviewers who can review new packages. This is currently a low workload. If you want to help, please send e-mail to the mailing list The mailing list: community-repository@lists.openmoko.org.

Reviewers must have the following:

  • an account on projects.openmoko.org
  • ssh public key on projects.openmoko.org
  • basic svn skills
  • basic opkg skills

Openmoko really appreciates your help!

 Current Reviewers
 Tick

How to create your own repository ?

TBD