Shipwright::Manual::BuUseruContribuShipwright::Manual::BuildMultiArchVessel(3)NAMEShipwright::Manual::BuildMultiArchVessel - Build a vessel with
multi-arch support
SYNOPSIS
In this tutorial, we'll build a vessel with multi-arch support, a.k.a
the vessel that I can use on multiple systems, e.g. Mac and Ubuntu.
DESCRIPTION
Shipwright starts to have multi-arch vessel support since 2.3.0. Since
then, all installed bin dirs and lib will live in as/$arch_name,
instead of top dir.
create
the vessel source is exactly the same as normal one. The only
different part is the way we build vessel with bin/shipwright-builder
We need to build the vessel on both Mac and Ubuntu.
Let's do this on Mac first:
$ ./bin/shipwright-builder --install-base /tmp/foo --as Mac
if we don't specify --as, the default name is the system's uname. e.g.
the name is Darwin on Mac.
after we built it on Mac, we need to transfer both shipyard and vessel
to ubuntu, then build it again, to let it build to the same vessel dir.
$ ./bin/shipwright-builder --install-base /tmp/foo --as Ubuntu
ditto. if we don't specify --as, the as name will be Linux
Then we're done, the built vessel can run on both Mac and Ubuntu
systems now.
fiddle
most CPAN modules are written in Perl, so is cross-platform, this will
results in not less redundance in vessel, we can use shipwright-filter
to squeeze it:
$ ./bin/shipwright-filter --squeeze
This will remove redundant files and link to the left files.
e.g. as/Mac/lib/perl5/App/SD.pm and as/Ubuntu/lib/perl5/App/SD.pm have
the same content, after the above cmd, the latter one will be deleted
and (hard) linked to the former one.
use
the multi-arch vessel can't auto-switch between the systems for us, so
we need to run a cmd to tell it to, e.g.
$ cd /tmp/foo
# on Mac, we switch to Mac
$ ./tools/shipwright-utility --switch Mac
# on Ubuntu, we switch to Ubuntu
$ ./tools/shipwright-utility --switch Ubuntu
SEE ALSO
Shipwright, Shipwright::Manual
AUTHORS
sunnavy "<sunnavy@bestpractical.com>"
LICENCE AND COPYRIGHT
Shipwright is Copyright 2007-2011 Best Practical Solutions, LLC.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.14.12Shipwright::Manual::BuildMultiArchVessel(3)
