termux-packages/README.md

136 lines
4.1 KiB
Markdown
Raw Normal View History

2019-02-12 02:44:10 +01:00
# Termux packages
2019-02-24 23:01:19 +01:00
[![Powered by JFrog Bintray](./.github/static/powered-by-bintray.png)](https://bintray.com)
[![build status](https://api.cirrus-ci.com/github/termux/termux-packages.svg?branch=master)](https://cirrus-ci.com/termux/termux-packages)
2016-01-13 01:29:13 +01:00
[![Join the chat at https://gitter.im/termux/termux](https://badges.gitter.im/termux/termux.svg)](https://gitter.im/termux/termux)
2016-01-13 01:28:47 +01:00
2019-09-22 17:28:44 +02:00
This project contains scripts and patches to build packages for the [Termux]
Android application.
2015-06-13 01:03:17 +02:00
2019-09-22 17:28:44 +02:00
There available packages only from main set. We have some additional
repositories:
2019-09-22 17:28:44 +02:00
- https://github.com/termux/game-packages
Game packages, e.g. `angband` or `moon-buggy`.
- https://github.com/termux/science-packages
Science-related packages like `gap` and `gnucap`.
- https://github.com/termux/termux-root-packages
All packages which usable only on rooted devices. Some stuff available
here requiring custom kernel (like `aircrack-ng` or `lxc`).
- https://github.com/termux/unstable-packages
Staging repository. Packages that are not stable available only here. New
packages most likely will be placed here too.
- https://github.com/termux/x11-packages
Packages requiring X11 Windowing System.
Termux package management quick how-to available on https://wiki.termux.com/wiki/Package_Management.
To learn about using our build environment, read the [Developer's Wiki].
## Project structure
There 2 main branches available:
- [master] - packages for Android 7.0 or higher.
Packages are built automatically by [CI] and published on [Bintray].
- [android-5] - packages for Android versions 5.x - 6.x.
Packages are built by @fornwall and published on https://termux.net.
Directories:
2019-02-12 02:56:43 +01:00
2019-06-08 13:44:09 +02:00
- [disabled-packages](disabled-packages/):
2019-02-12 02:56:43 +01:00
2019-09-22 17:28:44 +02:00
Packages that cannot be published due to serious issues.
2019-02-12 02:56:43 +01:00
2019-06-08 13:44:09 +02:00
- [ndk-patches](ndk-patches/):
2019-09-22 17:28:44 +02:00
Our changes to Android NDK headers.
2019-02-12 02:56:43 +01:00
2019-06-08 13:44:09 +02:00
- [packages](packages/):
2019-09-22 17:28:44 +02:00
Main set of packages.
- [sample](sample/):
Sample structure for creating new packages.
2019-02-12 02:56:43 +01:00
2019-06-08 13:44:09 +02:00
- [scripts](scripts/):
2019-02-12 02:56:43 +01:00
2019-09-22 17:28:44 +02:00
Set of utilities and build system scripts.
## Contributing
### Bug reports
2019-02-12 05:48:04 +01:00
2019-09-22 17:28:44 +02:00
Please, use templates for submitting bug reports. The *bug report* issue template
can be initialized by clicking on https://github.com/termux/termux-packages/issues/new?template=bug_report.md.
2019-02-12 05:48:04 +01:00
2019-09-22 17:28:44 +02:00
General requirements for bug reports are:
2019-02-12 05:48:04 +01:00
2019-09-22 17:28:44 +02:00
- All packages are up-to-date.
2019-02-12 05:48:04 +01:00
2019-09-22 17:28:44 +02:00
- Problem is not related to third-party software.
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
- Output of `termux-info` attached.
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
- Be ready to provide more info if requested.
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
### New packages
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
Use the *package request* template: https://github.com/termux/termux-packages/issues/new?template=package_request.md.
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
General requirements for new packages are:
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
- Packages should be open source and have widely recognised OSS licenses like
GNU GPL.
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
- Packages should not be installable via language-specific package managers such
as `gem`, `pip` or `cpan`.
2019-05-16 02:55:48 +02:00
2019-09-22 17:28:44 +02:00
- Packages should not be outdated dead projects.
- Be ready that your package request will not be processed immediately.
2019-05-16 02:55:48 +02:00
2019-02-12 05:48:04 +01:00
## Pull Requests
2019-09-22 17:28:44 +02:00
All pull requests are welcome.
We use [CI] for processing all pushes including pull requests. All build logs
and artifacts are public, so you can verify whether your changes work properly.
2019-02-12 05:48:04 +01:00
2019-09-22 17:28:44 +02:00
People who are new for packaging can begin with sending PRs for updating
packages. Check the outdated packages on https://repology.org/projects/?inrepo=termux&outdated=1.
2019-02-12 05:48:04 +01:00
2019-09-22 17:28:44 +02:00
Get started with information available on [Developer's Wiki].
2019-02-13 06:10:22 +01:00
2019-02-23 15:18:27 +01:00
## Contacts
2019-02-13 06:10:22 +01:00
2019-02-23 15:18:27 +01:00
- General Mailing List: https://groups.io/g/termux
2019-02-13 06:10:22 +01:00
2019-02-23 15:18:27 +01:00
- Developer Mailing List: https://groups.io/g/termux-dev
- Developer Chat: https://gitter.im/termux/dev or #termux/development on IRC/freenode.
2019-06-08 13:44:09 +02:00
If you are interested in our weekly development sessions, please check the
https://wiki.termux.com/wiki/Dev:Development_Sessions. Also, you may want to
check the https://wiki.termux.com/wiki/Development.
2019-09-22 17:28:44 +02:00
[Bintray]: <https://bintray.com/termux/termux-packages-24>
[CI]: <https://cirrus-ci.com/termux/termux-packages>
[Developer's Wiki]: <https://github.com/termux/termux-packages/wiki>
[Termux]: <https://github.com/termux/termux-app>
[android-5]: <https://github.com/termux/termux-packages/tree/android-5>
[master]: <https://github.com/termux/termux-packages/tree/master>