You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

135 lines
4.1 KiB

6 years ago
# Termux packages
6 years ago
[![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)
9 years ago
[![Join the chat at https://gitter.im/termux/termux](https://badges.gitter.im/termux/termux.svg)](https://gitter.im/termux/termux)
5 years ago
This project contains scripts and patches to build packages for the [Termux]
Android application.
9 years ago
The packages available here are only from main set. We have some additional
5 years ago
repositories:
5 years ago
- https://github.com/termux/game-packages
Game packages, e.g. `angband` or `moon-buggy`.
5 years ago
- https://github.com/termux/science-packages
Science-related packages like `gap` and `gnucap`.
5 years ago
- https://github.com/termux/termux-root-packages
Packages which can be used only on rooted devices. Some stuff available
here requires custom kernel (like `aircrack-ng` or `lxc`).
5 years ago
- https://github.com/termux/unstable-packages
Staging repository. Packages that are not stable are only available here.Most likely, new packages will also be placed here.
5 years ago
- https://github.com/termux/x11-packages
Packages that require X11 Windows System.
5 years ago
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].
5 years ago
- [android-5] - packages for Android versions 5.x - 6.x.
Packages are built by @fornwall and published on https://termux.net.
5 years ago
Directories:
- [disabled-packages](disabled-packages/):
Packages that cannot be published due to serious issues.
- [ndk-patches](ndk-patches/):
5 years ago
Our changes to Android NDK headers.
- [packages](packages/):
5 years ago
Main set of packages.
5 years ago
- [sample](sample/):
Sample structure for creating new packages.
- [scripts](scripts/):
Set of utilities and build system scripts.
5 years ago
## Contributing
### Bug reports
5 years ago
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.
5 years ago
General requirements for bug reports are:
5 years ago
- All packages are up-to-date.
5 years ago
- Problem is not related to third-party software.
6 years ago
5 years ago
- Output of `termux-info` attached.
6 years ago
5 years ago
- Be ready to provide more info if requested.
6 years ago
5 years ago
### New packages
6 years ago
5 years ago
Use the *package request* template: https://github.com/termux/termux-packages/issues/new?template=package_request.md.
6 years ago
5 years ago
General requirements for new packages are:
6 years ago
5 years ago
- Packages should be open source and have widely recognised OSS licenses like
GNU GPL.
6 years ago
5 years ago
- Packages should not be installable via language-specific package managers such
as `gem`, `pip` or `cpan`.
6 years ago
5 years ago
- Packages should not be outdated dead projects.
- Be ready that your package request will not be processed immediately.
6 years ago
## Pull Requests
5 years ago
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.
5 years ago
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.
5 years ago
Get started with information available on [Developer's Wiki].
6 years ago
## Contacts
6 years ago
- General Mailing List: https://groups.io/g/termux
6 years ago
- Developer Mailing List: https://groups.io/g/termux-dev
- Developer Chat: https://gitter.im/termux/dev or #termux/development on IRC/freenode.
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.
5 years ago
[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>