| 9 | | = Max OS X Installation Instructions = |
| 10 | | Current versions of Padre require a 32bit version of Perl, and wxWidgets 2.8.12. Since these are not the default on OSX, building Padre normally requires creating a self-contained 32bit perl, wxWidgets, and Padre. |
| | 9 | Open tickets can be found here: [wiki:osxbugs], and [http://widget.mibbit.com/?server=irc.perl.org&channel=%23padre hop on to IRC] as the best way to report any issues and give feedback. |
| | 10 | |
| | 11 | = Installation from source = |
| | 12 | |
| | 13 | There are several methods of installing Padre from source. As such, they require some familiarity with command-line usage of OsX. |
| | 14 | |
| | 15 | **System Perl vs User Perl:** Padre requires a 32bit version of Perl and wxWidgets 2.8.12. These are not the default on OsX. Additionally, the default "system" perl on OsX may be altered or changed in the course of software updates from Apple. Consequently, building Padre requires creating a self-contained perl, wxWidgets, and Padre. |
| | 21 | **Xcode:** On OsX most of the common development utilities that are referenced by perl (gcc, make, etc) are provided by installing Xcode. The instruction sets below assume that you have installed these or reasonable substitutes on your system, that they are properly in your path, etc. |
| | 22 | |
| | 23 | == Installation with Citrus Perl == |
| | 24 | |
| | 25 | Cirtus Perl is a portable distribution of perl that has pre-built Wx binaries and integration. A shortened form of installation instructions is below. Refer to the installation instructions on the download page below if you want full details. |
| | 26 | |
| | 27 | - Download Citrus Perl from http://www.citrusperl.com/platform/macosx.html |
| | 28 | - Unpack Citrus Perl into your favorite dev location: |
| | 29 | {{{ |
| | 30 | cd ~/dev |
| | 31 | tar xzvf ~/Downloads/citrusperl-standard-51402-20903-osx-i32-014.tar.gz |
| | 32 | }}} |
| | 33 | - This has created a "CitrusPerl" directory that has a fully isolated install of perl, including Wx. You can also use CPAN to add to this perl without polluting your system's install of perl with additional modules. (Also meaning that an apple update will not break your version of perl if you use this.) |
| | 34 | - Configure CirtusPerl to work in its new location |
| | 35 | {{{ |
| | 36 | ./CitrusPerl/bin/relocateperl |
| | 37 | ./CitrusPerl/bin/citrusvars.sh |
| | 38 | }}} |
| | 39 | - At this point you can alias commands in your `.bash_profile` to use this perl as your regular perl. |
| | 40 | {{{ |
| | 41 | alias perl=/Users/joe/dev/CitrusPerl/bin/perl |
| | 42 | alias perldoc=/Users/joe/dev/CitrusPerl/bin/perldoc |
| | 43 | alias cpan=/Users/joe/dev/CitrusPerl/bin/cpan |
| | 44 | }}} |
| | 45 | - To install Padre, invoke cpan and run the command "install Padre." It will build dependencies along the way, so it will take some time. |
| | 46 | {{{ |
| | 47 | cpan |
| | 48 | > install Padre |
| | 49 | > exit |
| | 50 | }}} |
| | 51 | - You can then alias and execute padre on the command line. |
| | 52 | {{{ |
| | 53 | alias padre=/Users/joe/dev/CitrusPerl/site/bin/padre |
| | 54 | }}} |
| | 55 | |
| | 56 | == Installation with Mac Ports == |
| | 57 | |
| | 58 | Mac Ports is a project to provide many GNU and Open Source utilities to OsX. It packages and installs them in `/opt/local`. |
| | 59 | |
| | 60 | - Mac Ports can be downloaded and installed as a package from http://www.macports.org/install.php and configured: |
| | 61 | {{{ |
| | 62 | sudo port -f selfupdate |
| | 63 | }}} |
| | 64 | - Install Perl and Wx (This will include many dependencies and take some time to compile and complete.) |
| | 65 | {{{ |
| | 66 | sudo port install perl5 wxWidgets |
| | 67 | }}} |
| | 68 | - Install Padre via CPAN |
| | 69 | {{{ |
| | 70 | /opt/local/bin/perl -MCPAN -e shell |
| | 71 | install Padre |
| | 72 | }}} |
| | 73 | |
| | 74 | ---- |
| | 75 | |
