# piaware_builder

**Repository Path**: summerlinux/piaware_builder

## Basic Information

- **Project Name**: piaware_builder
- **Description**: Debian package builder for piaware
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-01-04
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Piaware Debian Package Builder

This handles assembling and building the piaware Debian package.

## Checking everything is up to date

Update piaware_builder/changelog if needed.

Check the clone_or_update calls in sensible-build.sh to check that it is
including the correct repositories / branches.

## Prepare the package tree

Run piaware_builder/sensible-build.sh. It will:

* create piaware_builder/package/, the package directory
* check out the various parts of piaware from git into package/
* copy some control files from piaware_builder/sensible/ to package/debian/
* copy the changelog from piaware_builder/changelog to package/debian/changelog

If you are going to be building on another machine, you can copy the
package directory there; it is selfcontained.

## Check build prerequisites

Ensure that your build machine has the build dependencies mentioned in
package/debian/control:

* build-essential
* debhelper
* tcl8.6-dev
* autoconf
* python3-dev
* python3-venv
* dh-systemd
* libz-dev

If you use pdebuild it will do this for you.

## Build it

Change to the package directory on your build machine and build with a
debian package building tool of your choice:

```
  $ dpkg-buildpackage -b
```

or

```
  $ debuild
```

or

```
  $ pdebuild
```

etc.

## Fixing problems

If the build fails and you need to make some changes to fix it, you can
directly edit the contents of the package directory and rebuild. Once
you're happy you should commit the changes to the main repositories and
rerun sensible-build.sh - it will update / re-checkout the clones in
package/

The repositories under package/ are deliberately checked out in detached-
HEAD mode, both for sensibleness of updates and to discourage you from
doing any major changes directly in there!