Aports tree: Difference between revisions

From Alpine Linux
(Clenaning up again)
m (Amended grammar or style)
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
= Description of the aports tree =
The [http://git.alpinelinux.org/cgit/aports/ aports] tree contains a directory with the corresponding [[APKBUILD_Reference|APKBUILD]] file for every package/program. ''[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.
== Introduction ==
The [http://dev.alpinelinux.org/cgit/aports/ aports] tree is a [http://dev.alpinelinux.org/cgit/aports/tree/ directory tree] with many APKBUILD's.<BR>
''[http://dev.alpinelinux.org/cgit/abuild/tree/sample.APKBUILD APKBUILD]'' is a file containing "recepies" on how something should be built/compiled.<BR>
These files are used when building alpine from source.<BR>
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.
 
=== community ===
''community'' contains the additional packages that, for various reasons, are not guaranteed to be supported beyond six months.
 
=== testing ===
All new packages go to ''testing'' first. Package will be moved to ''main'' if there is positive feedback or for other good reasons. Packages in ''testing'' are not included in stable builds, but are only built for [[Aports what is edge|edge]].
 
=== 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 way or another.
 
=== unmaintained ===
When a package is no longer maintained and no longer builds, it is moved to ''unmaintained''. It is mostly in order to not break the build servers while still keeping the original APKBUILD available in case someone is willing to fix it.
 
== 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.''
apk add alpine-sdk
{{Cmd|apk add alpine-sdk}}
cd ~
{{Cmd|cd ~}}
git clone git://dev.alpinelinux.org/aports
{{Cmd|git clone git://dev.alpinelinux.org/aports}}
When the above is done you might be interested in fetching the latest updates.
When the above is done, you might be interested in fetching the latest updates:
cd ~
{{Cmd|cd ~/aports}}
git pull
{{Cmd|git pull}}
 
=See Also=
*[[Aports what is edge]]


== Create a APKBUILD ==
[[Category:Development]]
Your are encouraged to contribute with APKBUILD's the you have made.<BR>
Please look at '[[Creating_an_Alpine_package|Creating_an_Alpine_package]]' that describes how you make your own APKBUILD's.

Revision as of 03:16, 19 October 2017

The aports tree contains a directory with the corresponding APKBUILD file for every package/program. 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.

community

community contains the additional packages that, for various reasons, are not guaranteed to be supported beyond six months.

testing

All new packages go to testing first. Package will be moved to main if there is positive feedback or for other good reasons. Packages in testing are not included in stable builds, but are only built for edge.

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 way or another.

unmaintained

When a package is no longer maintained and no longer builds, it is moved to unmaintained. It is mostly in order to not break the build servers while still keeping the original APKBUILD available in case someone is willing to fix it.

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 ~/aports

git pull

See Also