Add installation and packaging targets

[Nikhil-4595]

Gitlab Username : nikhilnl

This commit completes the mandatory CPack assignment and optional bonus tasks.

Mandatory features:

• Added full installation targets in CMake:
  • cpackexample → /bin/
  • cpackexamplelib (static/shared) → /lib/
  • public headers → /include/cpackexamplelib/
• Added cmake/CPackConfig.cmake defining:
  • package metadata (name, maintainer, vendor, homepage, description)
  • TGZ and DEB generators only
  • /usr install prefix for Debian packaging
  • automatic dependency detection (CPACK_DEBIAN_PACKAGE_SHLIBDEPS=YES)
  • stripping of binaries (CPACK_STRIP_FILES=YES)
• Verified:
  • make install installs correctly
  • make package produces *.tar.gz and *.deb packages
  • Debian package installs via apt install ./pkg.deb
  • Installed binary runs correctly from /usr/bin

Lintian:

• Resolved major issues: missing maintainer phrase, missing description, unstripped binaries, undeclared ELF dependencies.
• Remaining warnings (expected for this exercise): no changelog, no copyright, no manpage.
• Initial and final lintian reports included in this PR.

How to build and test:

1. Build the Docker image:

docker build -t cpack-exercise .

2. Manual build/test inside the container (mandatory parts):

Start container interactively:

docker run --rm -it \
  --mount type=bind,source="$(pwd)",target=/mnt/cpack-exercise \
  cpack-exercise /bin/bash

Inside the container:

cd /mnt/cpack-exercise

rm -rf build
mkdir build
cd build

cmake -DCMAKE_INSTALL_PREFIX=/tmp/cpack-install ..
make -j"$(nproc)"

make install
ls -R /tmp/cpack-install

make package
ls cpackexample-0.1.0-Linux.tar.gz
ls cpackexample_0.1.0_arm64.deb

3. Install and test the Debian package:

apt update
apt install ./cpackexample_0.1.0_arm64.deb

which cpackexample
cpackexample

4. Lintian check:

apt install -y lintian
lintian ./cpackexample_0.1.0_arm64.deb

Bonus work:

• Added CMake option CPACKEXAMPLE_BUILD_SHARED to build cpackexamplelib as a shared library.
• Extended Dockerfile to automatically:
  • configure CMake with shared library mode
  • build and package the project inside a temporary directory
  • export only the generated .tar.gz and .deb into ./packages/ on the host
  • leave no build/ directory or temporary files on the host
• Added build-and-package.sh entrypoint script.

Automated packaging command:

docker run --rm \
  --mount type=bind,source="$(pwd)",target=/mnt/cpack-exercise \
  cpack-exercise

After container exits on the host:

ls packages

Expected output:

• cpackexample_0.1.0_arm64.deb
• cpackexample-0.1.0-Linux.tar.gz

This commit completes all required tasks and implements the full optional automation workflow.

[uekerman]

I was not able to run your code. Parts of your solution seem generated, are they?

[uekerman]

How is the variable different to BUILD_SHARED_LIBS?

[uekerman]

Better take the versions from the project, don't hard-code here.

[Nikhil-4595]

Okay, Sure. Will take care of it next time.

[uekerman]

Suggested change

	RUN cat > /usr/local/bin/build-and-package.sh << 'EOF'
	RUN <<'EOF'
	cat > /usr/local/bin/build-and-package.sh

Did your code work for you?

[Nikhil-4595]

It did, as per my knowledge. What is the issue @uekerman ?

[uekerman]

docker build -t cpack-exercise .
[+] Building 0.1s (2/2) FINISHED                                                                                   docker:default
 => [internal] load .dockerignore                                                                                            0.0s
 => => transferring context: 2B                                                                                              0.0s
 => [internal] load build definition from Dockerfile                                                                         0.0s
 => => transferring dockerfile: 2.15kB                                                                                       0.0s
Dockerfile:37
--------------------
  35 |     RUN cat > /usr/local/bin/build-and-package.sh << 'EOF'
  36 |     #!/bin/bash
  37 | >>> set -euo pipefail
  38 |     
  39 |     SRC_DIR=/mnt/cpack-exercise
--------------------
ERROR: failed to solve: dockerfile parse error on line 37: unknown instruction: set (did you mean user?)

I am using:

docker --version
Docker version 24.0.6, build ed223bc

[Nikhil-4595]

Hey @uekerman,
I tried to reproduce the Docker build error (unknown instruction: set) on my side but was not able to get it.

On my machine, I am using Docker Desktop 28.5.1. I tested the Dockerfile both with BuildKit enabled and disabled (using DOCKER_BUILDKIT=0), and in both cases it builds successfully, including the RUN cat > … << 'EOF' block with indented content.

I believe the build failure you're experiencing is due to a Docker version difference. You mentioned using Docker 24.0.6, which appears to have stricter parsing rules for heredoc syntax in Dockerfiles. In older Docker versions, the heredoc content (the lines between << 'EOF' and EOF) must start at the beginning of the line with no leading whitespace. When indentation is present, the legacy parser interprets those indented lines as Dockerfile instructions rather than heredoc content, which causes the error: unknown instruction: set.

Newer Docker versions (25.0+) introduced support for indented heredoc content, making the syntax more flexible and readable. Docker Desktop 28.5.1 supports this feature regardless of whether BuildKit is explicitly enabled or disabled.