79 lines
2.3 KiB
Plaintext
79 lines
2.3 KiB
Plaintext
|
+--------------------------------------+
|
||
|
|
| Welcome to the Glacier package index |
|
||
|
|
+--------------------------------------+
|
||
|
|
|
||
|
|
This is the official package repository for Glacier.
|
||
|
|
|
||
|
|
+---------------------+
|
||
|
|
| Submitting Packages |
|
||
|
|
+---------------------+
|
||
|
|
|
||
|
|
Submitting packages is limited to trusted users only.
|
||
|
|
Additionally, these steps assume you have access to gpc.
|
||
|
|
A copy is available in glacier-pkgs/devtools
|
||
|
|
|
||
|
|
1) Clone this repository. This will take a while.
|
||
|
|
|
||
|
|
2) Ensure your trusted user key is valid.
|
||
|
|
|
||
|
|
3) Create a package archive. This needs to include the following:
|
||
|
|
- The package's source tree
|
||
|
|
- INSTALL.sh
|
||
|
|
- UPDATE.sh
|
||
|
|
- REMOVE.sh
|
||
|
|
- package_name-pkginfo.json, containing the following:
|
||
|
|
{
|
||
|
|
"package_name": "",
|
||
|
|
"package_version": "",
|
||
|
|
"package_description": "",
|
||
|
|
"src_tree_size": "",
|
||
|
|
"exec_size": "",
|
||
|
|
"license": ""
|
||
|
|
}
|
||
|
|
- package_name.ts.sh, containing the following:
|
||
|
|
#!/bin/sh
|
||
|
|
|
||
|
|
touch /var/log/glacier/package_name.timestamp
|
||
|
|
date >> /var/log/glacier/package_name.timestamp
|
||
|
|
|
||
|
|
As well as submitting the package itself, a separate file, package_name.checksum
|
||
|
|
needs to be submitted as well.
|
||
|
|
|
||
|
|
Licenses need to follow this naming scheme:
|
||
|
|
- GPL V3, GPL V2
|
||
|
|
- MIT, BSD, Apache
|
||
|
|
For all other licenses, use the license name.
|
||
|
|
|
||
|
|
Once all of these files are in a directory, run:
|
||
|
|
(user)$ gpc check package_dir
|
||
|
|
# If any errors are detected by gpc, recheck everything
|
||
|
|
(user)$ gpc mkpkg package_dir
|
||
|
|
(user)$ mv package_dir/package_name.tar.gz package_dir/package_name.checksum .
|
||
|
|
|
||
|
|
4) Create a new branch from main. Name it the following:
|
||
|
|
maintainer_name-date
|
||
|
|
|
||
|
|
5) Submit the package, ensuring it is in the correct directory within this repository:
|
||
|
|
- world-testing, for system software
|
||
|
|
- galaxy-testing, for GPL software ONLY
|
||
|
|
- universe-testing, for other open source licensed software
|
||
|
|
- multiverse-testing, for proprietary, EULA, and binary-redistributable software
|
||
|
|
|
||
|
|
6) Merge your branch with main.
|
||
|
|
|
||
|
|
7) Test your package. 1 other trusted user must test the package
|
||
|
|
and ensure it works correctly.
|
||
|
|
|
||
|
|
After the package has been verified, repeat step 4, and move your package out
|
||
|
|
of testing and into stable.
|
||
|
|
|
||
|
|
+------------------------------+
|
||
|
|
| Reporting License Violations |
|
||
|
|
+------------------------------+
|
||
|
|
|
||
|
|
If your software is included in Glacier's package index, and we
|
||
|
|
are violating your license, reach out to any developer and we
|
||
|
|
will be happy to resolve the issue with you.
|
||
|
|
|
||
|
|
|