Aports tree: Difference between revisions

From Alpine Linux
(Add community, state that testing is only for edge)
(Minor rewords and cleanups)
 
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
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 [https://git.alpinelinux.org/aports/ aports] tree is a repository which contains [[APKBUILD_Reference|APKBUILD]] files for every Alpine package. An ''[https://git.alpinelinux.org/abuild/tree/sample.APKBUILD APKBUILD]'' file contains a "recipe" instructing how a given software package should be built/compiled and packaged. 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|abuild]] script reads the APKBUILD and executes the steps needed to create a package.
The [[Abuild and Helpers|abuild]] script reads an APKBUILD and executes the steps needed to create a package. Once 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'.


== Directories ==
== 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.
 
There are some directories placed in the [https://git.alpinelinux.org/aports/ aports] tree. Each directory represent a single package repository. As of 2024-07-07, the aports tree contains the following directories:


=== main ===
=== main ===
Line 10: Line 11:


=== community ===
=== community ===
''community'' contains the additional packages that, for various reasons, are not guaranteed to be supported beyond six months.
''community'' contain additional community maintained packages. For various reasons, these are not guaranteed to be supported beyond six months.


=== testing ===
=== testing ===
All new packages goes to ''testing'' first. Package will be moved to ''main'' if there positive feedback or other good reasons. Packages in ''testing'' are not included in stable builds, but are only built for edge.
All new packages go to ''testing'' first. Package will be moved to ''main'' or ''community'' if there is positive feedback or for other good reasons. Packages in ''testing'' are not included in stable builds, but are only built for [[Repositories#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 or another way.
 
=== unmaintained ===
When a package is no longer maintained and no longer builds, it is moved to 'unmaintained'. It is mostly to not break the build servers while still have to original APKBUILD available in case someone feels for fixing it.


== Fetch latest APKBUILD files ==  
== Fetch latest APKBUILD files ==  
Line 26: Line 21:
{{Cmd|apk add alpine-sdk}}
{{Cmd|apk add alpine-sdk}}
{{Cmd|cd ~}}
{{Cmd|cd ~}}
{{Cmd|git clone git://dev.alpinelinux.org/aports}}
{{Cmd|git clone <nowiki>git://git.alpinelinux.org/aports</nowiki>}}
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:
{{Cmd|cd ~/aports}}
{{Cmd|cd ~/aports}}
{{Cmd|git pull}}
{{Cmd|git pull}}
=See Also=
*[[Repositories#Edge|What is edge]]


[[Category:Development]]
[[Category:Development]]

Latest revision as of 10:10, 7 July 2024

The aports tree is a repository which contains APKBUILD files for every Alpine package. An APKBUILD file contains a "recipe" instructing how a given software package should be built/compiled and packaged. These files are used when building Alpine from source.

The abuild script reads an APKBUILD and executes the steps needed to create a package. Once 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'.

Directories

There are some directories placed in the aports tree. Each directory represent a single package repository. As of 2024-07-07, the aports tree contains the following directories:

main

main contains the basic set of packages for Alpine Linux.

community

community contain additional community maintained packages. For various reasons, these are not guaranteed to be supported beyond six months.

testing

All new packages go to testing first. Package will be moved to main or community 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.

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://git.alpinelinux.org/aports

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

cd ~/aports

git pull

See Also