HowTo compile on Mac-es - Revision history

Gmanz at 23:17, 14 February 2010

2010-02-14T23:17:21Z

Vollstrecker: Changed cvs to svn

2009-05-06T12:28:03Z

Changed cvs to svn

Vollstrecker: Corrected Spelling of Français in language selection

2008-09-25T14:04:09Z

Corrected Spelling of Français in language selection

Vollstrecker: Corrected Spelling of Español in language selection

2008-09-24T12:53:45Z

Corrected Spelling of Español in language selection

Vollstrecker: Removed Version Tag

2008-06-29T09:13:26Z

Removed Version Tag

Sturedman: removed link to outdated version

2008-05-31T21:06:12Z

removed link to outdated version

Vollstrecker: Added Link

2008-01-27T11:51:28Z

Added Link

Vollstrecker: Adjusted Links, Added Version-Tag

2008-01-23T09:05:53Z

Adjusted Links, Added Version-Tag

84.127.94.20 at 12:12, 20 December 2007

2007-12-20T12:12:28Z

Show changes

84.127.94.20 at 11:19, 20 December 2007

2007-12-20T11:19:30Z

New page

<center>[[HowTo_compile_on_Mac|English]] | [[HowTo_compile_on_Mac-de|Deutsch]] | '''Español'''</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release') or
# You compile it from a [[aMule CVS|CVS source snapshot]].

''The preceding version of this page covering [[aMule]] 2.0.0rc8 and earlier is archived [[HowTo_compile_on_Mac_v200rc8|here]].''

== Binary releases ==

If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Periodically compiled binary from cvs: [http://forum.amule.org/index.php?topic=5051.0 amule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==

Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://dl.amule.org aMule source].

=== Get the sources and development tools ===

==== [http://developer.apple.com/tools/xcode Xcode] ====

[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. [http://developer.apple.com/tools/xcode Xcode] is included on the OS X 10.4 DVD, but early versions of 10.4 were shipped with Xcode 2.0, so you will need to check that the version on your DVD is at least 2.1.

Alternatively, you can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first.

# Get Xcode from http://developer.apple.com/tools/download
# "Member Site"->"Log In"->"Download Software"->"Developer Tools"->"Download Xcode Tools last release">"Install"

==== [http://www.macports.org MacPorts] (formerly known as DarwinPorts) ====

[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://fink.sourceforge.net Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://trac.macosforge.org/projects/macports/wiki MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

The tools that you will need to install are:
# automake
# flex
# gettext (only required if you want to use a language other than English in aMule)
# libpng

==== [[wxWidgets|wxMac]] ====

[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://macos.apple.com Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

# Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac)
# Extract the archive (just double-click it)

Or get the current [[wx-cvs|CVS snapshot]]. Warning: the [[wxMac]] [[wx-cvs|CVS]] is frequently in a bad condition (e.g., currently you need to switch the vswprintf implementation that wx uses, see [http://forum.amule.org/index.php?topic=9915.msg58058#msg58058 here] for more details).

bash: cd ~/Desktop
bash: cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets login
Note: password is 'anoncvs'
bash: cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets checkout wxMac

==== [http://www.amule.org aMule itself] ====

# Get latest daily [[aMule CVS|CVS source snapshot]]: [http://www.hirnriss.net/?area=cvs aMule CVS]
# Extract the archive (just double-click it)

=== Compile the sources ===

Put the ''amule'' folder and the ''wxMac'' folder in the same place, e.g. on the desktop (if using another location, ensure that there are no spaces in the path as this can lead to file not found errors with [[wxMac]]).

==== Compile [[wxMac]] ====

This step is only needed once, even if you later download and compile a newer version of the [[aMule CVS]] source.

The following assumes that you have placed the above packages on your Desktop.<br>
''cd'' into the ''wxMac'' folder, ''configure'' and ''make'':

bash: cd ~/Desktop/wxMac-2.8.6/build
bash: ../configure --disable-shared --enable-unicode --enable-debug --enable-debug_gdb
bash: make

'''Note:''' The second command above makes sure that wxMac is compiled with debug information. This information allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you do not want to compile a debug version then you can use "--disable-debug --disable-debug_gdb" instead.

'''Note:''' If you want to compile a [http://en.wikipedia.org/wiki/Universal_binary Universal Binary] of aMule (i.e., a version of aMule that runs on both PowerPC based and Intel based Macs) then you can add the "--enable-universal_binary" parameter at the end of the second command. If you don't include this parameter wxMac and aMule will be compiled for your native architecture only.

'''Note:''' The above make command may take up to 45 minutes, depending on the speed of your CPU(s) and the parameters you chose.

==== Compile [[aMule]] ====

Now ''cd'' into the ''amule'' folder, ''configure'' and ''make'':

'''Note:''' You can copy and paste the 4 lines for ''./configure'' in one go.

bash: cd ~/Desktop/amule-cvs
bash: ./configure --disable-systray --disable-gtk --enable-embedded_crypto \
--with-wx-config=../wxMac-2.8.6/build/wx-config \
--enable-cas --enable-webserver --enable-amulecmd \
--enable-debug --disable-optimize

bash: make
bash: ./src/utils/scripts/mac_packager

'''Note:''' If you don't want to compile aMule with debug information (see above) you can use "--disable-debug --enable-optimize" in the configure statement.

'''Note:''' In order to compile aMule as a Universal Binary (see above) you will need to add the following parameters to the configure statement:
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk"

==== Running [[aMule]] ====
Once the mac_packager script has finished, you can move the aMule application from the amule-cvs folder to anywhere on your hard drive.

@@ Line 3: / Line 3: @@
 [[HowTo_compile_on_Mac-de|Deutsch]] |
 '''Espa&ntilde;ol''' |
-[[HowTo_compile_on_Mac-fr|Fran&ccedil;ais]]
+[[HowTo_compile_on_Mac-fr|Fran&ccedil;ais]] |
 </center>

@@ Line 9: / Line 9: @@
 # Puedes descargarte la aplicación finalizada ('binarios') o
-# compilarlo desde el [[aMule CVS|código CVS]].
+# compilarlo desde el [[aMule SVN|código SVN]].
 == Binarios ==
@@ Line 15: / Line 15: @@
 # Última versión de binarios: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
-# Binarios compilados periódicamente desde cvs: [http://forum.amule.org/index.php?topic=5051.0 foro de amule]
+# Binarios compilados periódicamente desde svn: [http://forum.amule.org/index.php?topic=5051.0 foro de amule]
 Ahora, para instalar los binarios, mueve la aplicación aMule a un archivo de tu elección (ej: ''/Aplcaciones'').
@@ Line 24: / Line 24: @@
 == Compilando desde el código ==
-Compilar desde el código te permite detectar y ver los informes de bugs, ya que puedes compilar y probar [[aMule CVS|aMule CVS]] diario.
+Compilar desde el código te permite detectar y ver los informes de bugs, ya que puedes compilar y probar [[aMule SVN|aMule SVN]] diario.
 Para compilar [[aMule]] desde el código, necesitas ciertas herramientas de desarrollo, como por ejemplo la librería [[wxWidgets]] y el [http://dl.amule.org código de aMule].
@@ Line 65: / Line 65: @@
 ==== [http://www.amule.org aMule por sí solo] ====
-# Obtén el [[aMule CVS|código CVS snapshot]]: [http://www.hirnriss.net/?area=cvs aMule CVS]
+# Obtén el [[aMule SVN|código SVN snapshot]]: [http://www.hirnriss.net/?area=cvs aMule SVN]
 # Extrae el archivo (doble click en él)
@@ Line 72: / Line 72: @@
 ==== Compila [[WxWidgets|wxMac]] ====
-Este paso sólo es necesario realizarlo una vez, si ya has descargado y compilado una versión más nueva de [[aMule CVS]].
+Este paso sólo es necesario realizarlo una vez, si ya has descargado y compilado una versión más nueva de [[aMule SVN]].
 Lo que se muestra a continuación, asume que ya has puesto los paquetes en tu escritorio.<br>
@@ Line 91: / Line 91: @@
 '''Nota:''' Puedes copiar y pegar las 4 lineas para ''./configure'' en una.
-  bash: cd ~/Desktop/amule-cvs
+  bash: cd ~/Desktop/amule-svn
   bash: ./configure --disable-systray --disable-gtk --enable-embedded_crypto    \
              --with-wx-config=../wxMac-2.8.6/build/wx-config    \
@@ Line 108: / Line 108: @@
 ==== Iniciando [[aMule]] ====
-Una vez que el script mac_packager haya finalizado, puedes mover la aplicación de aMule de la carpeta amule-cvs a cualquier lado de tu disco duro.
+Una vez que el script mac_packager haya finalizado, puedes mover la aplicación de aMule de la carpeta amule-svn a cualquier lado de tu disco duro.

@@ Line 3: / Line 3: @@
 [[HowTo_compile_on_Mac-de|Deutsch]] |
 '''Espa&ntilde;ol''' |
-[[HowTo_compile_on_Mac-fr|Français]]
+[[HowTo_compile_on_Mac-fr|Fran&ccedil;ais]]
 </center>

← Older revision		Revision as of 12:53, 24 September 2008
Line 1:		Line 1:
−	<center>[[HowTo_compile_on_Mac\|English]] \| [[HowTo_compile_on_Mac-de\|Deutsch]] \| '''~~Español~~''' \| [[HowTo_compile_on_Mac-fr\|Français]]</center>	+	<center>
		+	[[HowTo_compile_on_Mac\|English]] \|
		+	[[HowTo_compile_on_Mac-de\|Deutsch]] \|
		+	'''Español''' \|
		+	[[HowTo_compile_on_Mac-fr\|Français]]
		+	</center>

	Cómo conseguir e instalar [[aMule]] en [http://www.apple.com/macosx/ Apple Mac OS X].		Cómo conseguir e instalar [[aMule]] en [http://www.apple.com/macosx/ Apple Mac OS X].

← Older revision		Revision as of 09:13, 29 June 2008
Line 104:		Line 104:
	==== Iniciando [[aMule]] ====		==== Iniciando [[aMule]] ====
	Una vez que el script mac_packager haya finalizado, puedes mover la aplicación de aMule de la carpeta amule-cvs a cualquier lado de tu disco duro.		Una vez que el script mac_packager haya finalizado, puedes mover la aplicación de aMule de la carpeta amule-cvs a cualquier lado de tu disco duro.
−
−	~~== Version ==~~
−	~~This section needs to be translated, too<br>~~
−	~~Created by "Unknown User" on 20.12.07 at 13:19:<br>~~
−	~~Updated by [[User:Sturedman\|Sturedman]] 23:06, 31 May 2008 (CEST)~~

@@ Line 5: / Line 5: @@
 # Puedes descargarte la aplicación finalizada ('binarios') o
 # compilarlo desde el [[aMule CVS|código CVS]].
 == Binarios ==
@@ Line 109: / Line 107: @@
 == Version ==
 This section needs to be translated, too<br>
-Created by "Unknown User" on 20.12.07 at 13:19:
+Created by "Unknown User" on 20.12.07 at 13:19:<br>
-Updated by Vollstrecker on 23.01.08 at 10:06
+Updated by [[User:Sturedman|Sturedman]] 23:06, 31 May 2008 (CEST)

← Older revision		Revision as of 11:51, 27 January 2008
Line 1:		Line 1:
−	<center>[[HowTo_compile_on_Mac\|English]] \| [[HowTo_compile_on_Mac-de\|Deutsch]] \| '''Español'''</center>	+	<center>[[HowTo_compile_on_Mac\|English]] \| [[HowTo_compile_on_Mac-de\|Deutsch]] \| '''Español''' \| [[HowTo_compile_on_Mac-fr\|Français]]</center>

	Cómo conseguir e instalar [[aMule]] en [http://www.apple.com/macosx/ Apple Mac OS X].		Cómo conseguir e instalar [[aMule]] en [http://www.apple.com/macosx/ Apple Mac OS X].

@@ Line 9: / Line 9: @@
 == Binarios ==
 Si no quieres instalar y compilar todas las herramientas y códigos, obtén una aplicación de [[aMule]] precompilada. La última "versión" es 'estable', pero de tanto en tanto las aplicaciones están hechas  desde el código actual para permitir a más gente probar nuevas opciones disponibles y otras cosas.
@@ Line 22: / Line 21: @@
 == Compilando desde el código ==
 Compilar desde el código te permite detectar y ver los informes de bugs, ya que puedes compilar y probar [[aMule CVS|aMule CVS]] diario.
@@ Line 28: / Line 26: @@
 === Consigue el código y las herramientas de desarrollo ===
 ==== [http://developer.apple.com/tools/xcode Xcode] ====
 [http://developer.apple.com/tools/xcode Xcode] es el ambiente de desarrollo de [http://www.apple.com Apple]. Lo necesitamos para el compilador [http://gcc.gnu.org GCC].
@@ Line 41: / Line 37: @@
 ==== [http://www.macports.org MacPorts] (formerly known as DarwinPorts) ====
 [http://www.macports.org MacPorts] es un instalador open source con muchas herramientas para [http://macos.apple.com Mac OS X]. aMule necesita ciertas herramientas incluidas en MacPorts para compilar adecuadamente. También, puedes usar [http://fink.sourceforge.net Fink] para instalar estas herramientas o puedes instalarlas de forma manual.
@@ Line 54: / Line 49: @@
 ==== [[wxWidgets|wxMac]] ====
 [[wxWidgets|wxMac]] es el puerto de la librería [[wxWidgets]] para [http://macos.apple.com Mac OS X]. Esta librería es usada para convertir a aMule 'multi-plataforma'.
@@ Line 60: / Line 54: @@
 # Extrae el archivo (doble click en él)
-O descarga la actual [[wx-cvs|snapshot de CVS]]. Atención: [[wxMac]] [[wx-cvs|CVS]] se encuentrá habitualmente en una mala condición (ejemplo, actualmente necesitas cambiar la implementación que usa wx, lee [http://forum.amule.org/index.php?topic=9915.msg58058#msg58058 here] for more details).
+O descarga la actual [[wx-cvs|snapshot de CVS]]. Atención: [[WxWidgets|wxMac]] [[wx-cvs|CVS]] se encuentrá habitualmente en una mala condición (ejemplo, actualmente necesitas cambiar la implementación que usa wx, lee [http://forum.amule.org/index.php?topic=9915.msg58058#msg58058 here] for more details).
   bash: cd ~/Desktop
@@ Line 68: / Line 62: @@
 ==== [http://www.amule.org aMule por sí solo] ====
 # Obtén el [[aMule CVS|código CVS snapshot]]: [http://www.hirnriss.net/?area=cvs aMule CVS]
 # Extrae el archivo (doble click en él)
 === Compila el código ===
-Pon la carpeta ''amule'' y la carpeta ''wxMac'' en el mismo lugar, ej: en el escritorio (si están usando otra localización, asegúrate de que no hay espacios en la ruta, ya que puede causar errores con [[wxMac]]).
+==== Compila [[WxWidgets|wxMac]] ====
-−
 ==== Compila [[wxMac]] ====
-−
 Este paso sólo es necesario realizarlo una vez, si ya has descargado y compilado una versión más nueva de [[aMule CVS]].
@@ Line 94: / Line 85: @@
 ==== Compila [[aMule]] ====
 Ahora escribe ''cd'' a la carpeta de ''amule'' , ''configure'' y''make'':
@@ Line 116: / Line 106: @@
 ==== Iniciando [[aMule]] ====
 Una vez que el script mac_packager haya finalizado, puedes mover la aplicación de aMule de la carpeta amule-cvs a cualquier lado de tu disco duro.