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 an application project:

27

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

28

29

# for a library project:

30

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

31

32

33

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

34

35

Rename some stuff and have the inlcude files adapted:

cd $MYAPPNAME

scripts/rename_main_files.sh $MYAPPNAME

41

42

rm scripts/rename_main_files.sh

43

44

45

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

46

47

If you do not want windows binaries, remove it:

(((

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

54

rm -rf nsis src/*.nsi

55

56

# Variant 2: Remove all windows crossbuilding stuff

57

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

58

$EDITOR build/Makefile

59

60

61

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

62

)))

63

64

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

65

66

67

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

68

69

70

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

71

72

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

73

74

At least remove the link to this page ...

# edit ...

$EDITOR doc/ReadMe.txt

79

80

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

81

rm doc/ReadMe.txt

82

$EDITOR debian*/rules

83

84

85

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

86

87

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:

94

95

96

scripts/set_svn_ignore.sh

97

98

99

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

100

101

To produce the debian packages, just:

102

103

104

# 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.

113

114

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

115

116

(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:

123

124

125

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