====== QElectroTech bajo MacOSX ======

Esta página contiene todo el conocimiento del equipo sobre la compilación y ejecución de QElectroTech bajo MacOS X. El desarrollador no dispone de un ordenador Apple, no podemos garantizar absolutamente nada sobre el buen funcionamiento de QElectroTech bajo MacOS X.

===== Preparación del medio ambiente =====

==== Compilar un programa C++ : XCode ====
Para disponer de un compilador C++ y la herramienta make, usted debe instalar [[wp>XCode|XCode]] : http://developer.apple.com/TOOLS/xcode/

Comprobaciones: <code>
# Abrir una consola; el utilitario make debe estar presente:
NomDeLaMachine:~ votre_user$ make
make: *** No targets specified and no makefile found.  Stop.
</code>

==== Compilar un programa C++/Qt : Qt 4.4.x ====

Descargue e instale Qt para MacOS :
  * Ir a http://www.qtsoftware.com/downloads/opensource/appdev/mac-os-cpp
  * Descargue e instale los dos .dmg propuestos en la sección « Additional downloads »

Comprobaciones :
<code>
# Abrir una consola
# El utilitario qmake debe estar presente:
NomDeLaMachine:~ votre_user$ which qmake
/usr/bin/qmake

# Verificación de la versión de qmake:
NomDeLaMachine:~ votre_user$ qmake -version
QMake version 2.01a
Using Qt version 4.3.3 in /Library/Frameworks
</code>

==== Descargue las fuentes: Subversion ====
Para descargar y actualizar las fuentes de QElectroTech, usted necesitará Subversion:
  * http://subversion.tigris.org/getting.html#osx
  * http://www.lachoseinteractive.net/en/community/subversion/svnx/download/

Comprobaciones: 
<code>
# Abra una consola
NomDeLaMachine:~ votre_user$ which svn
/usr/local/bin/svn
NomDeLaMachine:~ votre_user$ svn --version
svn, version 1.4.4 (r25188)
compiled Jun 23 2007, 08:53:30
</code>

Si el comando ''which svn'' no devuelve nada:
  * Verifique la presencia del archivo /usr/local/bin/svn
  * Editar el archivo ~/.profile y añadir al final: <code bash>export PATH="${PATH}:/usr/local/bin"</code>
  * "Fuentes" entonces su .profile : <code bash>source ~/.profile</code>
Las comprobaciones deberían ahora funcionar.

===== Compilación =====
<code bash>
# cargamos las fuentes de QET en la máquina:
svn co svn://svn.tuxfamily.org/svnroot/qet/qet/trunk/ qelectrotech-svn
cd qelectrotech-svn

# se generan los archivos Makefile*:
qmake -spec macx-g++

# lance la compilación en modo debug, lo que permitirá obtener un stacktrace en caso de crash :
make debug

# si esto rersulta, se puede intentar lanzar QElectroTech :
cd misc
./launch_qet.sh
</code>

{{:doc:qet_macosx00.png?320x200|}}

===== Recursos =====
  * Llevar tu aplicación a MacOS X : http://chaos.troll.no/~ahanssen/devdays2007/BringingYourAppToTheMac.pdf

===== Problemas conocidos, comentarios, quejas =====
  * [ok] Problemas gráficos a nivel de los esquemas en un proyecto
  * [ok] El cuadro de mensajes de error de cuestiones simples no tiene el formato MacOS (burbuja que sale de la parte superior de la aplicación).
  * [ok] En el asistente de creación de nueva categoría: Paro imposible sin seguir todo el procedimiento: sin botón de cancelación, no de pequeño cruzar la parte superior de la ventana. Provea un botón de cancelación.
  * [ok] Supresión directa por atajo de teclado imposible (no hay tecla suppr sobre las máquinas Apple)

==== ToDo Benoît ====
  * Icono genérico sobre el « package » aplicación MacOS X
  * El programa no se inicia correctamente. Tiene que ir a través de la línea de comandos y jugar con los ajustes. (tiene que configurar el archivo *.pro) .
  * Colección de elementos no integrada al paquete MacOS X

===== Notas a granel =====
Estas son las notas a granel, puesto aquí para hacer un seguimiento de los experimentos de QET para MacOS X.

Plataforma de prueba: Mac OS 10.5.6 Intel

El archivo Info.plist parece contener un gran número de información relativa al paquete-aplicación de mac OS.
Éste casi no definido para QET da un resultado muy sumario. 

=== Creación de iconos al formato MAC-OS ===
Esto requiere el uso de una aplicación proporcionada bajo las herramienta de desarrollo MacOS.
/Desarrollador/Aplicaciones/Utilidades/Icon Composer

El icono exportado en PNG en 512*512 peu être imorté par glisser déposer dans la plus grande des cases (la duplicación en tamaño mas pequeño poco se hace automáticamente.  Lo que hicieron por el momento sin gran finura, pretendiendo sobre todo tener un funcionamiento mínimo).
Se registra a continuación el fichero en una esquina. 

=== Archivo Info.plist ===
Este es un fichero XML simple que asocia la entrada con valores. 
Un simple editor de texto de tipo Unix permite modificar eso (aún si una herramienta Apple se proporciona para hacerlo).

<key> es la entrada

<string> es el valor

== CFBundleIconFile ==
Permite definir el icono de la aplicación que será colocado en /Contants/Ressources/

== CFBundleVersion ==
Define la versión de la aplicación

== CFBundleGetInfoString ==
Esta es una linea de comentario, ideal para poner una nota sobre el autor y el copyright.

===== nota getsugah =====

[[http://developer.apple.com/documentation/DeveloperTools/Conceptual/SoftwareDistribution/Component_Packages/Component_Packages.html#//apple_ref/doc/uid/10000145i-CH7-SW1]]