123 lines
3.6 KiB
Markdown
123 lines
3.6 KiB
Markdown
# Zed Editor Packager
|
|
|
|
Automated packaging system for [Zed Editor](https://zed.dev/) for Debian/Ubuntu.
|
|
|
|
## Description
|
|
|
|
This project automatically creates `.deb` packages of Zed Editor from official GitHub releases and publishes them to a Gitea repository.
|
|
|
|
## Features
|
|
|
|
- **Automatic version detection**: Fetches the latest stable version from GitHub
|
|
- **DEB package building**: Creates a ready-to-install Debian package
|
|
- **CI/CD with Gitea Actions**: Automated workflow that:
|
|
- Checks daily for new versions
|
|
- Builds the package only if a new version is available
|
|
- Creates a Gitea release with the package
|
|
- Publishes the package to the Gitea Debian repository
|
|
|
|
## Local Usage
|
|
|
|
### Prerequisites
|
|
|
|
```bash
|
|
sudo apt-get install wget curl jq dpkg-dev
|
|
```
|
|
|
|
### Manual Building
|
|
|
|
```bash
|
|
# Build the package
|
|
make
|
|
|
|
# Or step by step
|
|
make download # Download the archive
|
|
make extract # Extract the archive
|
|
make deb # Create the .deb package
|
|
|
|
# Clean up
|
|
make clean
|
|
```
|
|
|
|
### Installation
|
|
|
|
```bash
|
|
# Install the locally created package
|
|
sudo dpkg -i build/zed-editor_*.deb
|
|
```
|
|
|
|
## Gitea Workflow
|
|
|
|
The [`.gitea/workflows/build-and-release.yml`](.gitea/workflows/build-and-release.yml) workflow runs:
|
|
|
|
- **Automatically**: Every day at 2 AM (cron)
|
|
- **Manually**: Via the Gitea interface (workflow_dispatch)
|
|
- **On push**: On every push to the `main` branch
|
|
|
|
### Required Configuration
|
|
|
|
To publish to the Gitea Debian repository, create a `PACKAGE_PUB_TOKEN` secret:
|
|
|
|
1. Generate a personal access token on Gitea with package permissions
|
|
2. Add it as a secret in the repository settings: `PACKAGE_PUB_TOKEN`
|
|
|
|
### Workflow Behavior
|
|
|
|
1. **Version check**: Compares the latest GitHub version with the latest Gitea release
|
|
2. **Early exit**: If versions match, the workflow stops immediately
|
|
3. **Build**: If a new version is detected, builds the .deb package
|
|
4. **Publishing**:
|
|
- Creates a Gitea release with the version tag
|
|
- Uploads the .deb file to the release assets
|
|
- Publishes the package to the Gitea Debian repository
|
|
|
|
## Package Structure
|
|
|
|
The package installs Zed in the following locations:
|
|
|
|
```
|
|
/opt/zed/ # Main application
|
|
/opt/zed/bin/zed # Main binary
|
|
/opt/zed/libexec/zed-editor # Editor binary
|
|
/opt/zed/lib/ # Shared libraries
|
|
/usr/bin/zed # Symbolic link
|
|
/usr/share/applications/zed.desktop # Desktop file
|
|
/usr/share/icons/hicolor/*/apps/zed.png # Icons
|
|
```
|
|
|
|
## Installation from Gitea Repository
|
|
|
|
Once the repository is configured:
|
|
|
|
```bash
|
|
# Add the repository (adapt according to your Gitea instance)
|
|
echo "deb https://git.rawleenc.dev/api/packages/YOUR_USERNAME/debian stable main" | sudo tee /etc/apt/sources.list.d/zed-editor.list
|
|
|
|
# Install
|
|
sudo apt update
|
|
sudo apt install zed-editor
|
|
```
|
|
|
|
## Makefile
|
|
|
|
The Makefile supports the following targets:
|
|
|
|
| Target | Description |
|
|
|------------|---------------------------------------------|
|
|
| `all` | Build the complete package (default target) |
|
|
| `download` | Download the archive from GitHub |
|
|
| `extract` | Extract the archive |
|
|
| `deb` | Create the .deb package |
|
|
| `clean` | Clean up temporary files |
|
|
| `help` | Display help |
|
|
|
|
## License
|
|
|
|
This project is a packaging tool. Zed Editor itself is subject to its own license.
|
|
|
|
## Notes
|
|
|
|
- The created packages are **unofficial**
|
|
- Binaries come directly from official Zed releases
|
|
- The packaging only adds system integration (desktop files, etc.)
|