PBA-cbs bootstrapping of portable C++ project

Setting up a portable C++ project still is a pain in the ass, especially if it shall be portable.

When trying to automate it in some way, we came to the conclusion that a full example in a public subversion repository is a good solutions because it's easy to use for you and easy to maintain for us.

4

5

=== {{id name="PBA-cbsbootstrappingofportableC++project-HowTo..."/}}HowTo ... ===

6

7

These are the steps for an ultra fast bootstrapping of a portable project relying on pba-cbs and [[our incarnation of the MinGW cross compilation toolchain>>doc:MINGW64.WebHome]].

8

9

===== {{id name="PBA-cbsbootstrappingofportableC++project-Preparations"/}}Preparations =====

10

11

You need deb sources for {{code language="none"}}pba{{/code}} ({{code language="none"}}any-pba-1.0{{/code}}) and //distro//{{code language="none"}}-mingw-5{{/code}} (i.e. {{code language="none"}}squeeze-mingw-5{{/code}} or {{code language="none"}}wheezy-mingw-5{{/code}}), see [[https:~~/~~/deb.clazzes.org>>url:https://deb.clazzes.org/||shape="rect"]].

12

13

For starters, You need to install the packages {{code language="none"}}pba-cbs{{/code}} and {{code language="none"}}subversion{{/code}}.

14

15

===== {{id name="PBA-cbsbootstrappingofportableC++project-Retrievethesceleton"/}}Retrieve the sceleton =====

16

17

Decide for the main name of your app:

MYAPPNAME="myapp"

Export our example from public svn:

24

25

26

# for a flat application project:

27

svn export "https://svn.clazzes.org/svn/pba/trunk/pba-helloworld-portable" $MYAPPNAME

28

29

# for a multi-module multi-program application project:

30

svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellobigworld-portable" $MYAPPNAME

31

32

# for a library project:

33

svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellolib-portable" $MYAPPNAME

34

35

36

===== {{id name="PBA-cbsbootstrappingofportableC++project-Renameandsearch'n'replace"/}}Rename and search'n'replace =====

37

38

Rename some stuff and have the inlcude files adapted:

cd $MYAPPNAME

scripts/rename_main_files.sh $MYAPPNAME

44

45

rm scripts/rename_main_files.sh

46

47

48

===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Removewindowsstuff"/}}Optional: Remove windows stuff =====

49

50

If you do not want windows binaries, remove it:

(((

# Variant 1: Remove NSIS installer only. For libraries common despite cross compilation.

57

rm -rf nsis src/*.nsi

58

59

# Variant 2: Remove NSIS installer and mingw-5

60

rm -rf nsis src/*.nsi debian-mingw-5

61

# Variant 3: Remove all windows crossbuilding stuff

62

rm -rf nsis src/*.nsi src/include-mingw.mk src/*.rc debian-mingw* build/win*

63

$EDITOR build/Makefile

64

65

66

===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianpackagemetainfos"/}}(% style="color: rgb(112,112,112);" %)Adapt debian package meta infos(%%) =====

67

)))

68

69

Change my name and e-mail to yours and adapt the description:

70

71

72

$EDITOR debian*/control debian*/changelog $(ls -1 src/*.pc.tmpl src/*.rc src/*.nsi src/*.h 2>/dev/null)

73

74

75

(% style="color: rgb(51,51,51);" %)Do not forget to change the icon, too!

76

77

===== {{id name="PBA-cbsbootstrappingofportableC++project-UpdateorremovetheReadMe"/}}Update or remove the ReadMe =====

78

79

At least remove the link to this page ...

# edit ...

$EDITOR doc/ReadMe.txt

84

85

# ... or remove the file and the reference in debian*/rules

86

rm doc/ReadMe.txt

87

$EDITOR debian*/rules

88

89

90

===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}(% style="line-height: 1.6666666;" %)Optional: Activate svn or another revision control system(%%) =====

91

92

Now (and before any build activity) is a very good time to put your project under subversion control:

svn add `pwd`

You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:

99

100

101

scripts/set_svn_ignore.sh

102

103

104

===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====

105

106

To produce the debian packages, just:

107

108

109

# this needs sudo privileges

pba-builddeps -i

pba-build -u

# or dpkg-build*

To only build the linux packages or only the windows packages, add {{code language="none"}}-o unix{{/code}} resp. {{code language="none"}}-o mingw{{/code}} to the pba-commands.

118

119

===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====

120

121

(Re)edit the {{code language="none"}}.nsi{{/code}} script template and replace all instances of "{{code language="none"}}Clazzes.org{{/code}}" with something of your choice:

$EDITOR src/*.nsi

Then "make" the {{code language="none"}}nsis{{/code}} directory:

128

129

130

make -C nsis && ls -ltr nsis/*.exe

131

132

133

===== {{id name="PBA-cbsbootstrappingofportableC++project-Optionalmulti-module/multi-programvariant:CreateModules,Programs"/}}Optional multi-module/multi-program variant: Create Modules, Programs =====

134

135

136

# create module common

137

scripts/create_module.sh common

138

139

# create program foobar-daemon

140

scripts/create_program.sh foobar-daemon

141