Ce readme explique comment démarrer la construction, l’utilisation et le développement avec la base de sources de Komodo Edit.

Alors que la source principale de Komodo Edit est hébergée sous ce dépôt, vous pouvez aussivouloir vérifier les dépôts individuels de composants/adons soushttps://github.com/Komodo au cas où vous ne voudriez contribuer qu’à un composant spécifique. Cela vous permettra d’économiser du temps et des tracas car vous n’auriez pas à construire le projet entier.

Table des matières

• Capture d’écran
• Téléchargement
• Réaction
• Construction de Komodo
  • Construction sur Windows
  • Construction sur Mac
  • Construction sur . Linux
  • Construire avec Docker
  • Construire des complications

Capture d’écran

Téléchargement

Vous pouvez télécharger Komodo Edit ici.

Feedback

Il existe plusieurs façons d’entrer en contact avec les devs de Komodo:

Github : https://github.com/Komodo/KomodoEdit

Forums : http://forum.komodoide.com/

Bug Tracker : https://github.com/Komodo/KomodoEdit/issues

IRC : irc://irc.mozilla.org/#komodo

Listes de diffusion : komodo-discuss & komodo-beta & komodo-announce

Construction de Komodo

Notez que ce sont des étapes simplifiées du processus de construction, pour un guide plus approfondi vérifiez (périmé) BUILD.txt.

Construction sous Windows

• Prérequis
• Étapes de construction

Prérequis

• Python >=2.7 (mais pas encore Python 3.x). Vous pouvez installer ActivePython à partir d’ici.

• Visual C++ 11.0 (alias Visual Studio 2012) et tous les SDK de la plateforme pour construire Mozilla avec vc11 comme décrit ici.

• Installer la version 1.9.0 du paquet « MozillaBuild-$ver.exe » dans le répertoire par défaut(c’est-à-dire « C:\mozilla-build »).

  • Une fois installé, supprimez les répertoires wget et hg
  • Téléchargez la version 2.2.0 et installez-la dans un répertoire temporaire, puis copiez le répertoire wget de la 2.2 dans le répertoire d’installation de 1.9 répertoire d’installation

• Installer le Perl <= 5.22

• Installer Mercurial

Voir http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites pour plus de détails sur les prérequis de construction de Windows. Cependant, suivre les étapes abovesteps est censé être suffisant pour obtenir la construction de Komodo.

Étapes de construction

• Checkout de Komodo Edit : git clone https://github.com/Komodo/KomodoEdit.git

• En utilisant la ligne de commande, entrez dans votre répertoire de checkout et exécutez:

   cd mozilla setenv-moz-msvc11.bat python build.py configure -k 11.10 python build.py distclean all

  Ceci va configurer et construire mozilla et peut prendre de 30 minutes à plusieurs heures (selon vos spécifications). Pour la plupart des machines modernes, cela devrait prendre environ une heure.

• Après que mozilla soit construit avec succès, retournez dans le répertoire principal du repo et construisez komodo:

   cd .. set PATH=util\black;%PATH% bk configure -V 11.10.0-devel # --without-binary-dbgp-clients bk build

  Cela devrait prendre beaucoup moins de temps que la construction de Mozilla.

• Une fois la construction terminée, vous pouvez simplement lancer Komodo en exécutant bk run

Si vous apportez des modifications à la source, vous devrez à nouveau exécuter bk build,ou simplement bk build && bk run pour revenir rapidement dans Komodo. Les constructions suivantes devraient être beaucoup plus rapides car une grande partie des données compilées sont mises en cache.

Construction sur Mac

• Prérequis pour Mac
• Étapes de construction

Prérequis pour Mac

• Python >=2.7 (mais pas encore Python 3.x). Vous pouvezinstaller ActivePython à partir d’ici.

  Si vous préférez les builds Python de python.org devraient également suffire.

• Xcode 6.4(SDK 10.9 & 10.10). Pour la version 8.0, voir ci-dessous. Vous pouvez obtenir la version 6.4 à partir du site de téléchargement des développeurs.

• MacOSX10.10.sdk ou plus ancien

• SEULEMENT le SDK 10.8 pour Code Intel. Peut être trouvé dans Xcode 5.1.1

• Si vous avez/besoin d’autres versions de Xcode installées alors vous pouvez utiliser xcode-select pour changer le Xcode actif:

  $ xcode-select -s /Path/To/Xcode\ 6.4.app/

• Outils de ligne de commande Xcode.

  Ouvrir les préférences de Xcode, puis dans l’onglet Téléchargements, sélectionner et installer les outils de ligne de commande.

• MacPorts. (Note : Fink peut fonctionner aussi mais la plupart des tests et des instructions de construction sont faits avec MacPorts.)

• autoconf v2.13. Une fois que vous avez installé MacPorts, il vous suffit d’exécutersudo port install autoconf213

• assurez-vous que vous utilisez clang ou gcc 4.2 (ou supérieur)

Voir http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesforplus de détails sur les prérequis de construction de Mac OS X. Cependant, suivre les étapes ci-dessus est censé être suffisant pour obtenir la construction de Komodo.

Prérequis Xcode 8

Officiellement, nous ne supportons pas Xcode 8, cependant il est possible de construire Komodounder Xcode 8 en utilisant de nouvelles étapes supplémentaires.

• Copiez les SDK 10.8 et 10.9 à partir d’une ancienne installation de XCode, ils devraient être dans:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Set MinimumSDKVersion to 10.9 in Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Vous assurez que vous utilisez ccache 3.1 (les versions ultérieures seront cassées)
• Configurer Mozilla avec --options=disable-webrtc

Étapes de construction

• Checkout Komodo Edit : git clone https://github.com/Komodo/KomodoEdit.git

• À l’aide du terminal, entrez dans votre répertoire de vérification et exécutez:

   1) cd komodo/mozilla 2) python build.py configure -k 10.10 3) python build.py all or python build.py distclean all (to delete and re-download Mozilla again)

  Ceci va configurer et construire mozilla et peut prendre de 30 minutes à plusieurs heures (selon vos spécifications). Pour la plupart des machines modernes, cela devrait prendre environ une heure.

** Construction avec GCC 5.0 et plus **

Si vous utilisez GCC 5.0, la construction peut échouer. Si c’est le cas, il y a des modifications à apporter à deux fichiers. Cependant, si vous exécutez une construction propre pour la première fois, vous devez permettre à cette partie de la construction d’échouer en premier. C’est parce que les fichiers sont dans la partie Mozilla de la construction qui doit être téléchargée en premier.

Ces fichiers doivent être modifiés:

1. /KomodoEdit/mozilla/build/moz3500-ko9.10/mozilla/configure.in

 @@ -7509,8 +7509,6 @@ eval $(CXX="$CXX" HOST_CXX="$HOST_CXX" $PYTHON -m mozbuild.configure.libstdcxx) AC_SUBST(MOZ_LIBSTDCXX_TARGET_VERSION) AC_SUBST(MOZ_LIBSTDCXX_HOST_VERSION)+ CXXFLAGS="$CXXFLAGS -D_GLIBCXX_USE_CXX11_ABI=0"+ HOST_CXXFLAGS="$HOST_CXXFLAGS -D_GLIBCXX_USE_CXX11_ABI=0"fi

Voir le bug #1153109 dans la base de données des bugs de Mozilla pour plus d’informations.

1. /KomodoEdit/mozilla/build/moz3500-ko9.10/mozilla/dom/ipc/Blob.cpp

@@ -3874,7 +3874,7 @@// Make sure we can't overflow.if (NS_WARN_IF(UINT64_MAX - aLength < aStart)) { ASSERT_UNLESS_FUZZING();- return nullptr;+ return false;}ErrorResult errorResult;@@ -3883,7 +3883,7 @@if (NS_WARN_IF(aStart + aLength > blobLength)) { ASSERT_UNLESS_FUZZING();- return nullptr;+ return false;}

Voir le portage vers GCC 5 pour plus d’informations.

• Après que mozilla ait été construit avec succès, retournez dans le répertoire principal du repo et construisez komodo:

   cd .. export PATH=`pwd`/util/black:$PATH # Komodo's "bk" build tool git submodule update --init git submodule update --remote bk configure -V 10.10.0-devel bk build

  Cela devrait prendre beaucoup moins de temps que la construction de Mozilla.

• Une fois la construction terminée, vous pouvez simplement lancer Komodo en exécutant bk run

Si vous apportez des modifications à la source, vous devrez à nouveau exécuter bk build,ou simplement bk build && bk run pour revenir rapidement dans Komodo. Les constructions ultérieures devraient être beaucoup plus rapides car une grande partie des données compilées sont mises en cache.

Construction sur Linux

Instructions pour Linux

Construction avec Docker

La façon la plus simple de commencer est d’utiliser notre image Docker, cela vous fournira essentiellement une construction de Komodo basée sur Ubuntu 12.04.

Après avoir cloné le dépôt, il suffit de naviguer dans {repo}/util/docker et de vérifier ./docklet --help

Pour utiliser l’image Docker, vous devez bien sûr avoir installé Docker ainsi que d’avoir activé la redirection X11 dans votre client SSH (devrait fonctionner par défaut sur la plupart des distroslinux).

Préparer l’image Docker

• Construire l’image Docker : ./util/docker/docklet image
• Démarrez votre conteneur : ./util/docker/docklet start
• SSH dans votre conteneur pour commencer à travailler : ./util/docker/docklet ssh

Vos fichiers de projet seront montés à /komodo/dev

NOTE – si vous mettez à jour depuis une version précédente où vos fichiers de projet étaient à /root/komodo, vous devrez fixer les autorisations sur vos dossiers Komodo project etprofile. Ie:

chown -R <my-username>:<my-group> <my-project-location>chown -R <my-username>:<my-group> ~/.komodoide

Vous devrez également refaire votre construction (distclean mozilla et komodo).

Étapes de construction

Une fois que votre image est préparée, vous pouvez suivre les étapes de construction pour linux telles que décrites ci-dessus. Vous allez les exécuter à partir du conteneur docker, donc ssh dansit en utilisant la commande ci-dessus et ensuite exécuter les commandes de /komodo/dev

Running

Une fois que votre construction est terminée, vous sortez du conteneur (exit) et pouvez alors exécuter Komodo avec

./util/docker/docklet run

Pour reconstruire Komodo (après avoir fait des changements) et l’exécuter à nouveau, vous pouvez utiliser

./util/docker/docklet build run

Si vos changements ne sont pas reflétés, vous pouvez avoir besoin de nettoyer votre build, pour ce faire, utilisez

./util/docker/docklet clean

Ou pour tout faire en une seule fois (nettoyer, construire et exécuter)

./util/docker/docklet clean build run

Complications de construction

Si des erreurs se produisent lors de votre première construction et qu’il n’est pas évident de résoudre le problème par vous-même, veuillez vous référer à la section Feedback sur la façon de nous contacter.

Notez que si des complications de construction surviennent après avoir mis à jour votre repo avec les dernierschangements, vous pourriez avoir besoin de vider votre cache local car il pourrait être en conflit avec les nouveaux changements, pour ce faire, exécutez bk distclean avant d’exécuter vos étapes de construction.

Conseils pro

Construire une seule pièce

Parfois bk build est trop et bk build quick n’est pas suffisant. Si bk build quick ne semble pas ramasser vos changements, essayez de pointer bk build sur la pièce en question.

Exemple

bk build build/release/modules/places #this will build the places module only

NOTE : Ne vous fiez pas à cette méthode car bk build quick est plus rapide et dans certains cas fait certaines étapes que l’exemple ci-dessus n’effectuera pas. Utilisez-la comme dernier effort avant d’essayer bk distclean && bk build.