apk v2 package format error

Problem

APK packages created using FPM version 1.17.0 cannot be installed on Alpine Linux 3.23 with the error below: ERROR: datadog-php-tracer_1.17.0_aarch64.apk: v2 package format error.

Root Cause

Alpine 3.23 introduced apk-tools v3.0.0, which enforces stricter APK v2 package validation. The new version requires a datahash field in the package's PKGINFO file - a SHA256 hash of the gzipped data.tar that's validated post-installation. Packages built with fpm 1.17.0 don't include this field, causing validation failures.

Additional information

https://github.com/DataDog/dd-trace-php/pull/3555