Community Repository

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (Review Packages)
(Vandalism removed)
 
(44 intermediate revisions by 12 users not shown)
Line 1: Line 1:
This page is still under construction.
+
{{Languages}}
Thanks :)
+
{{Note|The community repository described here never really took off. Please use the community repository at [http://opkg.org opkg.org] instead.}}
  
= Community Repository =
+
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:
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/community-repository/
+
  
The mailing list: http://lists.openmoko.org/mailman/listinfo/community-repository
 
  
= How to release packages =  
+
== 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]]
  
== Package Tags ==
+
Packages in '''Installer''' are displayed according to '''Package Tags'''.
If you want your package to be shown on Assassin, please add tag message on your package.  
+
To display a package through [[Om2008.8_Installer |Installer]], add the appropriate tag message.  
{|
+
{| class="wikitable" border:1px ;
 
! Category !! Tag  
 
! Category !! Tag  
 
|-  
 
|-  
Line 38: Line 44:
 
|}
 
|}
  
* For OE user, please adding the Tag by adding one line in your bb file
+
* For OpenEmbedded users, add a 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]:
+
:For [http://code.google.com/p/comic-reader/source/browse/trunk/data/comic-reader_svn.bb example]:
 
  PKG_TAGS_${PN} = "group::games"
 
  PKG_TAGS_${PN} = "group::games"
  
= Add Repository on Neo =  
+
== How to contribute ? ==
== Add repository by installing repository package ==
+
 
(Warning: It need the image after ASU)
+
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].
(Warning: It may not works yet, for repository not contains packages required)
+
 
* make sure your network works
+
Reviewers must have the following:
** using Wifi and USB network are both okay.  
+
* an account on projects.openmoko.org
* select Install bottom button
+
* ssh public key on projects.openmoko.org
* select "Repos" category
+
* basic svn skills
* select "communication-repository"
+
* basic opkg skills
* install this repository
+
 
 +
Openmoko really appreciates your help!
 +
  '''Current Reviewers'''
 +
  [http://wiki.openmoko.org/wiki/User_talk:Tick Tick]
  
== Add repository manually ==
+
== How to create your own repository ? ==
* create a file, here we call it community-repos.conf
+
> echo "arch community-repos 50" > community-repos.conf
+
> echo "src community-repos http://downloads.openmoko.org/community-repository/" >> community-repos.conf
+
* connect to your Neo with USB
+
> sudo ifconfig usb0 192.168.0.200
+
> scp community-repos.conf root@192.168.0.202:/etc/opkg/
+
* refresh the opkg metadata database
+
> ssh root@192.168.0.202
+
after connecting to Neo
+
> opkg refresh
+
  
= We need your help =
+
TBD
We need reviewers who review the new packages. If you want to help please send e-mail to the mailing list community-repository@lists.openmoko.org
+
  
== Review Packages ==
+
== See also ==
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 repository
+
* Program shall not collect user information and send to others unless it has very clear notification
+
* Program shall not destroy the system
+
  
 +
* 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 09: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

This page is still under construction. Thanks :)

Community Repository

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

Sites

The Repository: http://downloads.openmoko.org/community-repository/

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

How to release packages

You can release your package with ipk file.

Package Tags

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

Add Repository on Neo

Add repository by installing repository package

(Warning: It need the image after ASU) (Warning: It may not works yet, for repository not contains packages required)

  • make sure your network works
    • using Wifi and USB network are both okay.
  • select Install bottom button
  • select "Repos" category
  • select "communication-repository"
  • install this repository

Add repository manually

  • create a file, here we call it community-repos.conf
> echo "arch community-repos 50" > community-repos.conf
> echo "src community-repos http://downloads.openmoko.org/community-repository/" >> community-repos.conf
  • connect to your Neo with USB
> sudo ifconfig usb0 192.168.0.200
> scp community-repos.conf root@192.168.0.202:/etc/opkg/
  • refresh the opkg metadata database
> ssh root@192.168.0.202 
after connecting to Neo
> opkg refresh

We need your help

We need reviewers who review the new packages. If you want to help please send e-mail to the mailing list community-repository@lists.openmoko.org

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 repository
  • Program shall not collect user information and send to others unless it has very clear notification
  • Program shall not destroy the system