Community Repository

From Openmoko

(Difference between revisions)
Jump to: navigation, search
(How to release packages: Paste section from the Installer page)
(Vandalism removed)
 
(17 intermediate revisions by 8 users not shown)
Line 1: Line 1:
= Community Repository =
+
{{Languages}}
There is a community repository that every one can release your projects on Neo.
+
{{Note|The community repository described here never really took off. Please use the community repository at [http://opkg.org opkg.org] instead.}}
  
= Sites =
+
There are many [[Users Repositories]] where people can feed software for their Neo smartphones. This diversity makes it sometimes difficult to find the right package for the right distribution. Openmoko Inc. hosts a Community Repository as a central service where independent Neo application developers can release projects, so that installing a new application `just works out of the box'. It is a similar concept to the [http://www.ubuntu.com/community/ubuntustory/components Universe repository in Ubuntu]. The Repository is at:
The Repository: http://downloads.openmoko.org/repository/Multiverse
+
  
The mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository
+
http://downloads.openmoko.org/repository/Multiverse
  
= How to release packages =
 
  
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.  
+
== How to use the repository ? ==
You can release your package with ipk file.  
+
 
 +
This feed 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]. 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.
  
 
* [[Create package on projects.openmoko.org and upload]]
 
* [[Create package on projects.openmoko.org and upload]]
* how to create ipk files
+
* Here are [http://handhelds.org/moin/moin.cgi/BuildingIpkgs instructions to build ipkgs].
 +
** Link to ipkg-build Package: http://www.handhelds.org/download/packages/ipkg-utils
 
** Using OE
 
** Using OE
 
** [[Toolchain|Meta-toolchain]]
 
** [[Toolchain|Meta-toolchain]]
  
 
===How to add a package to Openmoko Repository===
 
 
 
==== 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 43:
 
|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 48:
 
  PKG_TAGS_${PN} = "group::games"
 
  PKG_TAGS_${PN} = "group::games"
  
= How to create your own repository =
+
== How to contribute ? ==
TBD
+
 
+
== Package Tags ==
+
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
+
For [http://code.google.com/p/comic-reader/source/browse/trunk/data/comic-reader_svn.bb example]:
+
PKG_TAGS_${PN} = "group::games"
+
 
+
== Adding the community repository to the package manager ==
+
 
+
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].
+
 
+
= We need your help =
+
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 62:
 
   [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
+
TBD
* 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 ===
+
== See also ==
* 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.
+
  
 +
* http://admin-trac.openmoko.org/trac/ticket/1518
 +
* http://admin-trac.openmoko.org/trac/ticket/1543
  
[[category:Documentation]]
+
[[Category:Software repositories]]
 
[[category:Community]]
 
[[category:Community]]

Latest revision as of 10:48, 21 May 2011

NOTE: The community repository described here never really took off. Please use the community repository at opkg.org instead.


There are many Users Repositories where people can feed software for their Neo smartphones. This diversity makes it sometimes difficult to find the right package for the right distribution. Openmoko Inc. hosts a Community Repository as a central service where independent Neo application developers can release projects, so that installing a new application `just works out of the box'. It is a similar concept to the Universe repository in Ubuntu. The Repository is at:

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


Contents

[edit] How to use the repository ?

This feed 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.

[edit] 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"

[edit] 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

[edit] How to create your own repository ?

TBD

[edit] See also

Personal tools

Community Repository

There is a community repository that every one can release your projects on Neo.

Sites

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

The mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository

How to release packages

Sharing applications is done by uploading packages to the Community Repository, which is a similar concept to the Multiverse repository in Ubuntu. Anyone can upload applications or even their own repository to share with fellow Neo owners. You can release your package with ipk file.


How to add a package to Openmoko Repository

Package Tags

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"

How to create your own repository

TBD

Package Tags

If you want your package to be shown on 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

For example:

PKG_TAGS_${PN} = "group::games"

Adding the community repository to the package manager

The community-repository is already installed by default in Om 2008.8. Otherwise, see instructions on the installer page.

We need your help

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 .


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

Review Packages

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.

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.