| 1 | QU'EST-CE QUE DARWINPORTS |
|---|
| 2 | |
|---|
| 3 | DarwinPorts est une infrastructure permettant de compiler, |
|---|
| 4 | d'installer et d'empaqueter un logiciel, similaire en termes de |
|---|
| 5 | fonctionnalités à l'architecture des ports FreeBSD afin de |
|---|
| 6 | maintenir une extensibilité future. |
|---|
| 7 | |
|---|
| 8 | DarwinPorts fonctionne et permet d'être compilé sur MacOS X 10.2 |
|---|
| 9 | (Darwin 6.0) et MacOS X 10.3 (Darwin 7.0.0). Le système est |
|---|
| 10 | portable, et est écrit en TCL avec un set limité d'extensions TCL |
|---|
| 11 | en C. |
|---|
| 12 | |
|---|
| 13 | Le "DarwinPorts User Guide" est disponible à : |
|---|
| 14 | http://www.opendarwin.org/projects/darwinports/guide/ |
|---|
| 15 | |
|---|
| 16 | Pour une documentation plus appronfondie sur l'architecture |
|---|
| 17 | interne de ce système de ports, reportez-vous au fichier |
|---|
| 18 | base/docs/INTERNALS. |
|---|
| 19 | |
|---|
| 20 | Notez svp que l'architecture de DarwinPorts est composé de deux |
|---|
| 21 | parties. "L'infrastructure de DarwinPorts", qui réside dans le |
|---|
| 22 | sous-répertoire base/ est le seul composant obligatoire du système, |
|---|
| 23 | et le répertoire "dports" qui contient la description des logiciels |
|---|
| 24 | portés. Le dernier composant peut être optionnel et peut être |
|---|
| 25 | récupéré sur le net ou une copie locale peut également être |
|---|
| 26 | utilisée. |
|---|
| 27 | Reportez-vous à la documentation sur /etc/ports/sources.conf |
|---|
| 28 | ci-dessous. |
|---|
| 29 | |
|---|
| 30 | INSTALLATION |
|---|
| 31 | |
|---|
| 32 | Pour des instructions d'installation spécifiques à d'autres |
|---|
| 33 | plateformes, reportez-vous au fichier base/docs/README.platforms. |
|---|
| 34 | |
|---|
| 35 | Étapes de l'installation : |
|---|
| 36 | |
|---|
| 37 | 1. cd base/ |
|---|
| 38 | ./configure |
|---|
| 39 | Vous place dans le répertoire base/ et lance le script |
|---|
| 40 | configure. Des paramètres peuvent être passés au script |
|---|
| 41 | (cf. ci-dessous). |
|---|
| 42 | |
|---|
| 43 | 2. make |
|---|
| 44 | Lancez 'make' pour compiler tout ce qui est nécessaire. |
|---|
| 45 | |
|---|
| 46 | 3. sudo make install |
|---|
| 47 | Lancez 'sudo make install' pour installer DarwinPorts |
|---|
| 48 | sur votre système. |
|---|
| 49 | |
|---|
| 50 | 4. [optionnel] éditez /etc/ports/ports.conf |
|---|
| 51 | Le fichier de configuration "/etc/ports/ports.conf" |
|---|
| 52 | définit la majeure partie des options de configuration de |
|---|
| 53 | l'infrastructure de DarwinPorts si vous desirez changer les |
|---|
| 54 | chemins et emplacements ou sonts stockés les données, |
|---|
| 55 | changez les options suivantes : |
|---|
| 56 | |
|---|
| 57 | portdbpath - Spécifie la base où stocker les données |
|---|
| 58 | spécifiques au système de ports. |
|---|
| 59 | |
|---|
| 60 | prefix - Indique la base dans laquelle installer les ports |
|---|
| 61 | |
|---|
| 62 | [REQUIS pour Mac OS X 10.2] |
|---|
| 63 | Tcl 8.3 qui est fourni avec Mac OS X 10.2 n'inclut pas la |
|---|
| 64 | fonction [file link] utilisée par le méchanisme appelé |
|---|
| 65 | "Port Images", donc pour utiliser DarwinPorts vous devrez |
|---|
| 66 | changer le type d'installation dans /etc/ports/ports.conf |
|---|
| 67 | |
|---|
| 68 | Changez la ligne suivante : |
|---|
| 69 | portinstalltype image |
|---|
| 70 | en : |
|---|
| 71 | portinstalltype direct |
|---|
| 72 | |
|---|
| 73 | 5. [optionnel] éditez /etc/ports/sources.conf |
|---|
| 74 | Le fichier /etc/ports/sources.conf liste l'emplacement des |
|---|
| 75 | hiérarchies des ports locales et distantes. Si l'argument |
|---|
| 76 | "--with-dports-dir=RÉP." n'a pas été utilisé lors du |
|---|
| 77 | lancement du script "./configure", la hiérarchie de dports |
|---|
| 78 | (darwinports/dports, depuis la copie que vous avez |
|---|
| 79 | installé) sera ajoutée au fichier "source.conf". |
|---|
| 80 | |
|---|
| 81 | Tout le code TCL nécessaire sera compilé et installé comme indiqué ci- |
|---|
| 82 | dessous: |
|---|
| 83 | [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0 |
|---|
| 84 | [Mac OS X 10.3] /Library/Tcl/darwinports1.0 |
|---|
| 85 | [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0 |
|---|
| 86 | - Librairie TCL permettant d'interagir avec le |
|---|
| 87 | système DarwinPorts. |
|---|
| 88 | |
|---|
| 89 | PREFIX est situé par défaut à /opt/local mais ce choix peut être |
|---|
| 90 | modifié en changeant le répertoire pour base/ et en lançeant |
|---|
| 91 | manuellement ./configure avec l'argument --prefix |
|---|
| 92 | |
|---|
| 93 | $PREFIX/bin/port |
|---|
| 94 | - Utilitaire en mode texte pour la compilation de port |
|---|
| 95 | $PREFIX/share/darwinports/ |
|---|
| 96 | - Librairies TCL internes du système de ports |
|---|
| 97 | |
|---|
| 98 | Les fichiers suivants sont fournis en vue de la personnalisation |
|---|
| 99 | du système : |
|---|
| 100 | |
|---|
| 101 | /etc/ports/ports.conf |
|---|
| 102 | - Réglages personnels des ports pour les utilisateurs |
|---|
| 103 | /etc/ports/sources.conf |
|---|
| 104 | - Liste des sources pour les ports (endroit où récupérer les |
|---|
| 105 | données des ports) |
|---|
| 106 | |
|---|
| 107 | |
|---|
| 108 | UTILISATION DE LA COMMANDE 'PORT' |
|---|
| 109 | |
|---|
| 110 | Si vous ne l'avez déjà fait, ajoutez /opt/local/bin à votre variable |
|---|
| 111 | path (ou $PREFIX/bin si vous avez choisi d'installer DarwinPorts dans |
|---|
| 112 | un autre emplacement). Si vous ne savez pas comment faire, ajoutez la |
|---|
| 113 | ligne suivante dans votre fichier ~/.cshrc (cela est valable si vous |
|---|
| 114 | utilisez tcsh sous Panther également). Si ce fichier n'existe pas, |
|---|
| 115 | créez-le. |
|---|
| 116 | |
|---|
| 117 | set path=($path /opt/local/bin) |
|---|
| 118 | |
|---|
| 119 | Si vous utilisez Panther (OSX 10.3), ajoutez la ligne suivante à votre |
|---|
| 120 | fichier ~/.profile (cela est valable si vous utilisez un shell de type |
|---|
| 121 | Bourne sous Jaguar également). Si ce fichier n'existe pas, créez-le. |
|---|
| 122 | |
|---|
| 123 | export PATH=$PATH:/opt/local/bin |
|---|
| 124 | |
|---|
| 125 | Vos changements ne seront pris en compte que lorsque vous ouvrirez un |
|---|
| 126 | nouveau shell. |
|---|
| 127 | |
|---|
| 128 | La commande suivante compilera et installera le port : |
|---|
| 129 | |
|---|
| 130 | port install <nom_du_port> |
|---|
| 131 | |
|---|
| 132 | Pour rechercher un port spécifique, essayez d'utiliser "port search" : |
|---|
| 133 | |
|---|
| 134 | port search vi |
|---|
| 135 | |
|---|
| 136 | Référez-vous à la page man de "port" pour une documentation plus |
|---|
| 137 | complète sur cette commande. |
|---|
| 138 | |
|---|
| 139 | Il est également possible d'effectuer des opérations, comme compiler |
|---|
| 140 | ou récupérer tous les ports du système en utilisant la commande |
|---|
| 141 | "portall". Elle prend les mêmes arguments essentiels que la commande |
|---|
| 142 | "port" mais opère de façon interactive sur chaque port dans dports/. |
|---|
| 143 | Lorsque vous effectuez un "make clean" depuis ce répertoire, par |
|---|
| 144 | exemple, un "portall clean" est également invoqué pour nettoyer |
|---|
| 145 | complètement. |
|---|
| 146 | |
|---|
| 147 | CRÉER DE NOUVEAUX PORTS |
|---|
| 148 | |
|---|
| 149 | Un port consiste en un répertoire contenant un fichier Portfile et ses |
|---|
| 150 | fichiers associés. Actuellement les seuls fichiers livrés avec un port |
|---|
| 151 | sont les patchs, et sont au minimum censés être gardés. |
|---|
| 152 | |
|---|
| 153 | Un fichier Portfile consiste en un code TCL valide, évalué par un |
|---|
| 154 | interpréteur de DarwinPorts. Les fichiers Portfiles utilisent une |
|---|
| 155 | syntaxe très stricte composée de paires de type clé/valeur, permettant |
|---|
| 156 | d'autoriser à l'auteur l'utilisation complète des fonctionnalités |
|---|
| 157 | offertes par TCL lorsque cela lui est nécessaire. |
|---|
| 158 | |
|---|
| 159 | Pour commencer reportez-vous au fichier base/doc/exampleport et la page |
|---|
| 160 | man de portfile(7). |
|---|
