Aports tree - Revision history

Prabuanand: moved content to Git and added links

2025-10-06T04:56:09Z

moved content to Git and added links

← Older revision		Revision as of 04:56, 6 October 2025
Line 36:		Line 36:
	# There is a maintainer who claims responsibility for the maintenance of the package and can help fix things if they break in the future.		# There is a maintainer who claims responsibility for the maintenance of the package and can help fix things if they break in the future.

	== ~~Fetch latest APKBUILD files~~ ==		== See Also ==

	~~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>~~		* [[Developer Documentation]]
	~~'''''Note~~:~~''' You only need to do these 2 steps once! Next time you can skip this part~~.''		* [https://git.alpinelinux.org/aports/ aports]
	~~{{Cmd\|apk add alpine-sdk}}~~		* [https://git.alpinelinux.org/aports/ readonly aports]
	~~{{Cmd\|cd ~}}~~
	~~{{Cmd\|git clone <nowiki>git~~://git.alpinelinux.org/aports~~</nowiki>}}~~
	~~When the above is done, you might be interested in fetching the latest updates:~~
	~~{{Cmd\|cd ~~~/aports}}
	~~{{Cmd\|git pull}}~~

	~~=See Also=~~

	*[[Repositories#Edge\|What is edge]]

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

Prabuanand: consolidated all development focussed content to this page page from Repositories page

2025-10-06T04:15:45Z

consolidated all development focussed content to this page page from Repositories page

← Older revision		Revision as of 04:15, 6 October 2025
Line 9:		Line 9:
	=== main ===		=== main ===

	''main'' contains the basic set of packages for Alpine Linux. Main repository is for packages that are either core of the linux system or are dependencies of other core packages. A package in main cannot have a dependency in community or testing and a package in community cannot have a dependency on packages in testing.		'''main''' contains the basic set of packages for Alpine Linux. Main repository is for packages that are either core of the linux system or are dependencies of other core packages. A package in main cannot have a dependency in community or testing and a package in community cannot have a dependency on packages in testing.

			Packages in '''main''' repository also have official special documentation, are always available for all releases and will have substitutions if some are not continued from upstream. Commonly these packages are selected due to their responsibility and stability with respect to upstream availability.

			Packages from ''community'' or (rarely) ''testing'' can be accepted into the ''main'' repository.

	=== community ===		=== community ===

	''community'' contain community maintained packages. For various reasons, these are not guaranteed to be supported beyond six months.		'''community''' contain community maintained packages. Packages in '''community''' repository are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions and could end if the user(s) stops; they may also be removed in a future release due to lack of support by upstream authors. For various reasons, these are not guaranteed to be supported beyond six months.

			The '''community''' repository was introduced with Alpine Linux version [https://alpinelinux.org/posts/Alpine-3.3.0-released.html 3.3.0]. Packages from ''testing'' that are accepted go to the ''community'' repository.

	=== testing ===		=== testing ===

	All new packages should normally go to ''testing'' first. After a reasonable testing period, if ~~the package is complete i.e it has a working and sane default configuration, necessary init scripts (if applicable) and has a maintainer,~~ there is positive feedback, then that package in the testing will be moved into community repository or very rarely to ''main'' repository for other good reasons. ~~Packages~~ in ''testing'' are not ~~included~~ in ~~[[Repositories~~#~~Release Branches\|stable builds]]~~, ~~but are only built~~ for ~~[[Repositories~~#~~Edge\|edge]]~~.		All new packages should normally go to '''testing''' first. Packages in ''testing'' are not included in [[Repositories#Release Branches\|stable builds]], but are only built for [[Repositories#Edge\|edge]]. After a reasonable testing period, if there is positive feedback and the package meets certain [[#Requirements to move from testing\|requirements]], then that package in the testing will be moved into community repository or very rarely to ''main'' repository for other good reasons.

			If a package stays in testing long enough, it gets moved to unmaintained/purged (gets cleaned up every 6 months).

			==== Requirements to move from testing ====

			Before a package can move from ''testing'' to ''main'' or ''community'', the following requirements must be met:

			# Package must work correctly, including the init.d script (if provided) and sane default configuration.
			# Packaging must be done correctly, with files installed in the right places, e.g. configs are in <code>/etc/</code> and not in <code>/usr/etc</code>.
			# Package dependencies are handled correctly. Abuild can (and should) autodetect shared libs, for example ''sqlite-libs'' provides ''so:libsqlite3.so.0''. Any package linked to ''sqlite'' should have an automatically (by abuild) added <code>depend=so:libsqlite3.so.0</code> and the user should not have to manually add a <code>depend="sqlite-libs"</code> in the APKBUILD.
			# There is a maintainer who claims responsibility for the maintenance of the package and can help fix things if they break in the future.

	== Fetch latest APKBUILD files ==		== Fetch latest APKBUILD files ==

Prabuanand: moved content from Creating patches page

2025-10-05T16:01:00Z

moved content from Creating patches page

← Older revision		Revision as of 16:01, 5 October 2025
Line 5:		Line 5:
	== Directories ==		== Directories ==

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

	=== main ===		=== main ===
	''main'' contains the basic set of packages for Alpine Linux.
			''main'' contains the basic set of packages for Alpine Linux. Main repository is for packages that are either core of the linux system or are dependencies of other core packages. A package in main cannot have a dependency in community or testing and a package in community cannot have a dependency on packages in testing.

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

	=== testing ===		=== 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 [[Repositories#Edge\|edge]].
			All new packages should normally go to ''testing'' first. After a reasonable testing period, if the package is complete i.e it has a working and sane default configuration, necessary init scripts (if applicable) and has a maintainer, there is positive feedback, then that package in the testing will be moved into community repository or very rarely to ''main'' repository for other good reasons. Packages in ''testing'' are not included in [[Repositories#Release Branches\|stable builds]], but are only built for [[Repositories#Edge\|edge]].

	== Fetch latest APKBUILD files ==		== 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 27:		Line 31:

	=See Also=		=See Also=

	*[[Repositories#Edge\|What is edge]]		*[[Repositories#Edge\|What is edge]]

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

WhyNotHugo: Minor rewords and cleanups

2024-07-07T10:10:03Z

Minor rewords and cleanups

← Older revision		Revision as of 10:10, 7 July 2024
Line 1:		Line 1:
	The [https://git.alpinelinux.org/aports/ aports] tree contains ~~a directory with the corresponding~~ [[APKBUILD_Reference\|APKBUILD]] ~~file~~ for every package~~/program~~. ''[https://git.alpinelinux.org/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 and Helpers\|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 [https://git.alpinelinux.org/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 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 [[Repositories#Edge\|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]].

	== Fetch latest APKBUILD files ==		== Fetch latest APKBUILD files ==

Tesa: /* Directories */ remove dropped sections

2024-05-05T16:15:03Z

Directories: remove dropped sections

← Older revision		Revision as of 16:15, 5 May 2024
Line 14:		Line 14:
	=== testing ===		=== 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 [[Repositories#Edge\|edge]].		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 [[Repositories#Edge\|edge]].

	~~=== non-free ===~~
	The packages in ''non-free'' are violating the standards of the [https://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 ==		== Fetch latest APKBUILD files ==

Zcrayfish: Fixed wikilink.

2023-11-19T18:50:35Z

Fixed wikilink.

← Older revision		Revision as of 18:50, 19 November 2023
Line 1:		Line 1:
	The [https://git.alpinelinux.org/aports/ aports] tree contains a directory with the corresponding [[APKBUILD_Reference\|APKBUILD]] file for every package/program. ''[https://git.alpinelinux.org/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 contains a directory with the corresponding [[APKBUILD_Reference\|APKBUILD]] file for every package/program. ''[https://git.alpinelinux.org/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.

	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.		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 and Helpers\|abuild]] script reads the APKBUILD and executes the steps needed to create a package.

	== Directories ==		== Directories ==

Sertonix: update git links and use https

2023-08-07T09:58:40Z

update git links and use https

← Older revision		Revision as of 09:58, 7 August 2023
Line 1:		Line 1:
	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.		The [https://git.alpinelinux.org/aports/ aports] tree contains a directory with the corresponding [[APKBUILD_Reference\|APKBUILD]] file for every package/program. ''[https://git.alpinelinux.org/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.

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

	== 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. A short description of every directory can be found in this section.

	=== main ===		=== main ===
Line 16:		Line 16:

	=== non-free ===		=== 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.		The packages in ''non-free'' are violating the standards of the [https://www.fsf.org/ Free Software Foundation] (FSF) about copying, redistributing, and modifying computer programs in one way or another.

	=== unmaintained ===		=== unmaintained ===

Sertonix: prevent link in git clone command

2023-08-07T09:56:39Z

prevent link in git clone command

← Older revision		Revision as of 09:56, 7 August 2023
Line 26:		Line 26:
	{{Cmd\|apk add alpine-sdk}}		{{Cmd\|apk add alpine-sdk}}
	{{Cmd\|cd ~}}		{{Cmd\|cd ~}}
	{{Cmd\|git clone git://git.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}}

Encode: link to repositories page

2022-06-27T01:21:52Z

link to repositories page

← Older revision		Revision as of 01:21, 27 June 2022
Line 13:		Line 13:

	=== testing ===		=== 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]].		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 [[Repositories#Edge\|edge]].

	=== non-free ===		=== non-free ===

Encode: link to repositories page

2022-06-27T01:19:21Z

link to repositories page

← Older revision		Revision as of 01:19, 27 June 2022
Line 32:		Line 32:

	=See Also=		=See Also=
	*[[~~Aports what~~ is edge]]		*[[Repositories#Edge\|What is edge]]

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

← Older revision		Revision as of 09:56, 7 August 2023
Line 26:		Line 26:
	{{Cmd\|apk add alpine-sdk}}		{{Cmd\|apk add alpine-sdk}}
	{{Cmd\|cd ~}}		{{Cmd\|cd ~}}
	{{Cmd\|git clone git://git.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}}