Aports tree: Difference between revisions

From Alpine Linux
m (major changes)
Line 1: Line 1:
== Introduction ==
The [http://git.alpinelinux.org/cgit/aports/ aports] tree contains for every package/program a directory with the corresponding [[APKBUILD_Reference|APKBUILD]] file. ''[http://git.alpinelinux.org/cgit/abuild/tree/sample.APKBUILD APKBUILD]'' is a file containing "recipes" on how something should be built/compiled. These files are used when building alpine from source.
The [http://dev.alpinelinux.org/cgit/aports/ aports] tree is a [http://dev.alpinelinux.org/cgit/aports/tree/ directory tree] with many APKBUILD's. ''[http://dev.alpinelinux.org/cgit/abuild/tree/sample.APKBUILD APKBUILD]'' is a file containing "recipes" on how something should be built/compiled. These files are used when building alpine from source. In your build environment you would have at least one ''[http://dev.alpinelinux.org/cgit/abuild/tree/sample.APKBUILD APKBUILD]'' for each package/program.


When alpine is compiled, you will no longer see (or have use of) the ''[http://dev.alpinelinux.org/cgit/abuild/tree/sample.APKBUILD APKBUILD]''. It is not included in the 'iso' or 'tar.gz'.
When Alpine Linux is compiled, you will no longer see (or have use of) the APKBUILD. It is not included in the 'iso' or 'tar.gz'. The [[Abuild|abuild]] script reads the APKBUILD and executes the steps needed to create a package.


The ''[http://dev.alpinelinux.org/cgit/abuild/tree/abuild abuild]'' script reads the ''[http://dev.alpinelinux.org/cgit/abuild/tree/sample.APKBUILD APKBUILD]'' and executes the steps needed to create a package.
== Directories ==
There are some directories placed in the [http://git.alpinelinux.org/cgit/aports/ aports] tree. A short description of every directory can be found in this section.


== Fetch latest APKBUILD's ==  
=== main ===
''main'' contains the basic set of packages for Alpine Linux.
 
=== testing ===
All new packages goes to ''testing'' first. Package will be moved to ''main'' if there positive feedback or other good reasons.
 
=== non-free ===
The packages in ''non-free'' are violating the standards of the [http://www.fsf.org/ Free Software Foundation] (FSF) about copying, redistributing, and modifying computer programs in one or another way.
 
=== unstable ===
''unstable'' is the place for unstable packages. The packages in this directory often have several issues.
 
== Fetch latest APKBUILD files ==  
While inside your [[Setting up the build environment 1.9|build environment]] you need to install some needed packages and you need to fetch the APKBUILD's from the server (fetch the aports tree).<BR>
While inside your [[Setting up the build environment 1.9|build environment]] you need to install some needed packages and you need to fetch the APKBUILD's from the server (fetch the aports tree).<BR>
'''''Note:''' You only need to do these 2 steps once! Next time you can skip this part.''
'''''Note:''' You only need to do these 2 steps once! Next time you can skip this part.''
Line 17: Line 29:


== Create a APKBUILD ==
== Create a APKBUILD ==
You are encouraged to contribute the APKBUILD's that you have made.<BR>
You are encouraged to contribute the APKBUILD files that you have made.<BR>
Please look at [[Creating_an_Alpine_package|Creating an Alpine package]] page that describes how you make your own APKBUILD's.
Please look at [[Creating_an_Alpine_package|Creating an Alpine package]] page that describes how you make your own APKBUILD files.

Revision as of 06:42, 7 December 2011

The aports tree contains for every package/program a directory with the corresponding APKBUILD file. APKBUILD is a file containing "recipes" on how something should be built/compiled. These files are used when building alpine from source.

When Alpine Linux is compiled, you will no longer see (or have use of) the APKBUILD. It is not included in the 'iso' or 'tar.gz'. The abuild script reads the APKBUILD and executes the steps needed to create a package.

Directories

There are some directories placed in the aports tree. A short description of every directory can be found in this section.

main

main contains the basic set of packages for Alpine Linux.

testing

All new packages goes to testing first. Package will be moved to main if there positive feedback or other good reasons.

non-free

The packages in non-free are violating the standards of the Free Software Foundation (FSF) about copying, redistributing, and modifying computer programs in one or another way.

unstable

unstable is the place for unstable packages. The packages in this directory often have several issues.

Fetch latest APKBUILD files

While inside your build environment you need to install some needed packages and you need to fetch the APKBUILD's from the server (fetch the aports tree).
Note: You only need to do these 2 steps once! Next time you can skip this part.

apk add alpine-sdk

cd ~

git clone git://dev.alpinelinux.org/aports

When the above is done you might be interested in fetching the latest updates.

cd ~

git pull

Create a APKBUILD

You are encouraged to contribute the APKBUILD files that you have made.
Please look at Creating an Alpine package page that describes how you make your own APKBUILD files.