Adapting PBA to new Debian Release
Introduction
About every 2 years Debian introduces a new release.
The following notes shall provide a step-by-step-plan for adapting the PBA Package Builder + Archiver to a new Debian release and shall make it more efficient for the next Debian.
The first version of this page was created when Debian Buster was on it's way from Full Freeze to GA.
Currently we are in the progress of adapting to Debian Bullseye, and we have switched from svn to git. Currently this is WORK IN PROGRESS rg. Bullseye.
Adapting pba to new Debian Release
Preprations
NEWDN=buster
# we prefix name of feature branches issue number or epic numbers
ISSUENR="e1"BRANCHNAME="${ISSUENR}_adapt_to_debian_11_${NEWDN}" ; echo "Branch name: ${BRANCHNAME}"
Adaptions for phase 1, towards GA
In phase 1 we make the new distribution known in the sense of adding a template for distributions.d/.
git checkout main ; git pull ; git checkout main
git branch ${BRANCHNAME} && git checkout ${BRANCHNAME} && git status
git push --set-upstream origin ${BRANCHNAME}
cat src/etc/pba/distributions.d/${OLDDN} |sed -e "s/${OLDDN}/${NEWDN}/g" >src/etc/pba/distributions.d/${NEWDN}
git add src/etc/pba/distributions.d/${NEWDN}
# evtl. drop ancient ones
git rm src/etc/pba/distributions.d/foobar
${EDITOR:-vi} debian/changelog debian/rules debian/pba-common.install src/etc/pba/distributions.d/${NEWDN} debian/control
# src/etc/pba/builder.conf.template src/lib/build-functions.pl
# commit
git commit -m "Adding support for new Debian distro ${NEWDN}"
# release it
pba-release
Adapt HelloWorld Projects
git checkout main ; git pull ; git checkout main
git branch ${BRANCHNAME} && git checkout ${BRANCHNAME} && git status
git push --set-upstream origin ${BRANCHNAME}
pba-raiseversion
# decide next version
pba-raisversion -b 1.2.3 "Adding new Debian target distro ${NEWDN}"
git add debian*/control debian*/changelog
PBAO="."
# or
PBAO="arch|unix"
# or in phase 2 or when combining
PBAO="arch|unix|7"
#pba-builddeps -i -o ${PBAO}
#pba-instdeps -i -o ${PBAO}
pba-build -u -i -o ${PBAO}
# solve eventual problems
PBADD=$(ls -1d debian* |grep -v mingw |head -1)
${EDITOR:-vi} ${PBADD}/changelog ${PBADD}/control
pba-localbuild -u -o ${PBAO}
# evtl.
#pba-localrpmbuild -u -o ${PBAO}
# wait for success
git commit -m "Adding support for new Debian distro ${NEWDN}"
git push
# optional, eventually after merge in main
pba-release -o ${PBAO}
LATER (after adapting Fancylibs below) repeat for pba-helloworld-portable (with -o unix).
Repeat for pba-hellolib-portable (with -o unix).
Repeat for pba-hellobigworld-portable (with -o unix).
... with -o unix or later -o "unix|9".
Adapt FANCYLIBS
--- current point of adaption to Debian Bullseye ---
See Adapting FancyLibs & MinGW-Pkg from Debian 9 Stretch to 10 Buster, Mingw-7 to Mingw-8.
Adapt pba-helloworld-portable
See above, use -o unix.
Create PBA-Builder tarballs
See eventual separate notes (my ITEG's PBA-Tarball Notes are not public, sorry).
Adapt MinGW
MinGW-Adapt pba-hello*-portable
See above, with -o "unix|9" instead of "-o unix".
Adaptions for phase 2, once new release is settled
Once the new Debian release is settled and all VIP libraries and current projects can be built for it, we can declare it the new default value for DefaultDistribution in pba-builder.conf.
# commit
git commit -m "Making new Debian distro ${NEWDN} default for DefaultDistribution in pba-builder.conf"
# release it
pba-release