Code Conversion Guide/fr: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | - | ||
| 1 | + | Cette page traite de la façon de convertir le code existant en Delphi ou Kylix pour fonctionner avec le compilateur [[Free Pascal]] et l'IDE Lazarus. Bien que Lazarus et le compilateur Free Pascal ont des aspects en commun avec Delphi et Kylix, ce ne sont pas des clones. Il y a un certain nombre de différences de convention et d'appel de bibliothèque ... et dans quelques secteurs , FPC est amélioré et peut être plus exigeant sur une syntaxe correcte . Veuillez voir le guide [[Lazarus For Delphi Users]] pour une description de quelques unes des différences fonctionnelles . | |
| 2 | 2 | ||
| 3 | - | ||
| 3 | + | Le but de ce guide est de documenter certaines des différences spécifiques qui sont fréquemment rencontrées pendant le processus de conversion de code en traduisant le code existant de Delphi à Lazarus. | |
| 4 | 4 | ||
| 5 | - | ||
| 5 | + | Ce document a été placé dans la base de connaissance du wiki ainsi il pourrait être facilement complété par n'importe qui qui avait rencontré un problème unique et voudrait le signaler pour que d'autres s'en rendent compte. | |
| 6 | 6 | ||
| 7 | + | ## Contents | |
| 8 | + | ||
| 9 | + | * 1 Choix d'un composant ou d'une bibliothèque pour la conversion | |
| 10 | + | * 1.1 Où trouver le code pour convertir | |
| 11 | + | * 1.2 Autorisation | |
| 12 | + | * 1.3 Dépendances | |
| 13 | + | * 1.4 Problèmes liés au Compilateur | |
| 14 | + | * 1.5 Questions sur l'OS et de plate-forme | |
| 15 | + | * 2 Faire la conversion | |
| 16 | + | * 2.1 Paramétrer l'environnement de Lazarus pour un projet de conversion | |
| 17 | + | * 2.1.1 Créer un projet test | |
| 18 | + | * 2.1.2 Choses initiales à regarder | |
| 19 | + | * 2.1.3 Sources Delphi VCL, Kylix CLX dans Lazarus | |
| 20 | + | * 2.2 Problèmes de conversion et solutions | |
| 21 | + | * 2.2.1 Fichier Delphi / Kylix équivalents dans Lazarus | |
| 22 | + | * 2.2.2 Convertir les projets/fiches/unités Delphi vers Lazarus | |
| 23 | + | * 2.2.3 Choix du bon mode du compilateur | |
| 24 | + | * 2.2.4 Considérations sur les logiciels multiplate-formes | |
| 25 | + | * 2.2.5 Les variables utiles pour le compilateur | |
| 26 | + | * 2.2.6 32bit / 64 bit support | |
| 27 | + | * 2.2.7 Trouver un identificateur manquant | |
| 28 | + | * 2.2.8 Différences principales d'unité entre Lazarus et Delphi | |
| 29 | + | * 2.2.9 Différences des Propriétés et methodes entre Delphi et FPC/LCL | |
| 30 | + | * 2.2.10 Différence sémantique | |
| 31 | + | * 2.2.10.1 Ordre d'évaluation des paramètres | |
| 32 | + | * 2.2.10.2 Procédures/Fonctions imbriquées en variables procédurales | |
| 33 | + | * 2.2.11 différence de syntaxe | |
| 34 | + | * 2.2.11.1 Pour affecter un gestionnaire à un évènement vous devez le préfixer avec "@" | |
| 35 | + | * 2.2.11.2 En appelant une variable procédure utilisez cette syntaxe : theprocname() | |
| 36 | + | * 2.2.11.3 Déréférencement de pointeur d'enregistrement | |
| 37 | + | * 2.2.11.4 Des parenthèses pour acceder aux chars d'une propriété string d'un objet | |
| 38 | + | * 2.2.11.5 Ne confondez pas le pointeur et ce qui est pointé | |
| 39 | + | * 2.2.12 Ressources | |
| 40 | + | * 2.3 Une autre méthode pour convertir un projet Delphi ou Kylix vers Lazarus | |
| 41 | + | * 3 Obtenir de l'aide | |
| 42 | + | * 3.1 Documentation | |
| 43 | + | * 3.2 Support par les pairs | |
| 44 | + | * 3.3 Bases de connaissance | |
| 45 | + | * 4 Empaqueter et livrer votre composant | |
| 46 | + | * 4.1 Création d'un paquet Lazarus pour votre(vos) composant(s) | |
| 47 | + | * 4.2 Documentation | |
| 48 | + | * 4.3 Création d'une page de livraison du code | |
| 49 | + | * 4.4 Soumission de votre comoposant | |
| 50 | + | ||
| 7 | 51 | ## Choix d'un composant ou d'une bibliothèque pour la conversion | |
| 8 | 52 | ||
| 9 | 53 | ### Où trouver le code pour convertir | |
| 10 | 54 | ||
| 11 | - | ||
| 55 | + | Il y a beaucoup de code disponible sur le net qui peut être converti pour être utilisé par FPC et Lazarus . Voici une [[Page Of Code Sites/fr|Page de sites avec du code]] qui est juste un début. S'il vous plaît, complétez-le si vous connaissez d'autres bonnes adresses. TurboPower Software a récemment réalisé son offre commerciale entièrement sous MPL (Licence publique de Mozilla). Une liste de paquets disponibles peut être trouvée [ici ](<http://sourceforge.net/users/tpsfadmin/>). | |
| 12 | 56 | ||
| 13 | - | ||
| 57 | + | Pour éviter un double effort, les paquets qui ont été déjà été convertis sont listés sur la page [[Components and Code examples/fr|composants et Exemples de code]]. Si vous avez converti un paquet ou travaillez sur un, veuillez ajouter une note sur la page [[Current conversion projects/fr|Projets en cours de conversion]]. | |
| 14 | 58 | ||
| 15 | 59 | ### Autorisation | |
| 16 | 60 | ||
| 17 | - | ||
| 61 | + | Il existe des licences depuis le Freeware (domaine public) jusqu’à des versions plus restrictives interdisant toute modification, redistribution ou usage commercial. Avant d’entreprendre toute conversion, il est nécessaire d’examiner les droits attachés au code. Le type de la licence de protection est essentiel lorsque l’on colle sur une Form un composant imposant des droits incompatibles avec l’ensemble de l’application concernée. | |
| 18 | 62 | ||
| 19 | - | ||
| 63 | + | Lors de la traduction de composants, respectez les souhaits de l’auteur et conservez les copyrights et les entêtes des licences avec les adresses E-mail et les url. De même, il souhaitable d'informer l'auteur que ses composants sont en cours de conversion ... Surtout si le composant est sous une License restrictive. Dans le cas de composants oubliés et plus exploités, les auteurs révisent souvent les droits associés. | |
| 20 | 64 | ||
| 21 | - | ||
| 65 | + | Généralement le domaine public (Freeware) et le LGPL/MPL sont les plus souples pour la diffusion de composants. Pour obtenir plus d’information concernant la[Définition Open Source <http://www.opensource.org/docs/definition.php>] est un bon commencement. Vous trouverez aussi d’autres types de licences et leur impact sur le code y étant attaché. | |
| 22 | 66 | ||
| 23 | 67 | ### Dépendances | |
| 24 | 68 | ||
| 25 | - | ||
| 69 | + | Une autre étape avant de commencer à travailler sur une conversion est vérifier que le code n'a pas des dépendances profondes avec d'autres paquets qui pourraient ne pas être disponibles ou qui représente un défi considérable de conversion. Quelques offres de freeware sont liées à ou bien prolongent les paquets propriétaires qui ne sont fréquemment plus disponibles ou viennent avec des licences inadéquates. | |
| 26 | 70 | ||
| 27 | 71 | ### Problèmes liés au Compilateur | |
| 28 | 72 | ||
| 29 | - | ||
| 73 | + | Voir : | |
| 30 | 74 | ||
| 31 | - | ||
| 32 | - | ||
| 75 | + | * [Problèmes connus](<http://www.freepascal.org/probs.var>) | |
| 76 | + | * [Traqueur de bogues](<http://bugs.freepascal.org/my_view_page.php>) | |
| 33 | 77 | ||
| 34 | 78 | ### Questions sur l'OS et de plate-forme | |
| 35 | 79 | ||
| 36 | - | ||
| 80 | + | Lazarus et le compilateur Free Pascal sont des outils de developpement multi plate-forme et multi-architecture. En revanche , la plupart du code existant Delphi a été spécifiquement conçu pour fonctionner sur un processeur Intel sous Win32 . Si votre composant candidat a beaucoup de code spécifique Win32 , il pourrait être sage d'essayer et de trouver une plateforme alternative . Mais ne laissez pas ceci vous stopper... c'est véritablement étonnant ce que la LCL supporte! | |
| 37 | 81 | ||
| 38 | 82 | ## Faire la conversion | |
| 39 | 83 | ||
| 40 | 84 | ### Paramétrer l'environnement de Lazarus pour un projet de conversion | |
| 41 | 85 | ||
| 42 | 86 | #### Créer un projet test | |
| 43 | 87 | ||
| 44 | - | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 48 | - | ||
| 49 | - | ||
| 88 | + | * Placer le code à convertir dans un sous-répertoire (par exemple: convertdir) | |
| 89 | + | * Lancer Lazarus | |
| 90 | + | * Fichier->Tout Enregistrer vers le sous-répertoire convertdir. Les noms significatifs pour le Projet et l'unité par défaut sont optionnels. | |
| 91 | + | * Ouvrir l'unité « principale » à convertir dans convertdir | |
| 92 | + | * L'ajouter au projet : Projet->Ajouter le fichier de l'éditeur au Projet | |
| 93 | + | * Lancer Outils->Vérification rapide de la syntaxe ou lancer Executer->Construire Tout pour commencer . | |
| 50 | 94 | ||
| 51 | 95 | #### Choses initiales à regarder | |
| 52 | 96 | ||
| 53 | - | ||
| 97 | + | * Les noms de fichier sont sensibles à la casse avec les versions de compileurs 1.0.x. Si vous travaillez avec cette version, faire que tout vos noms de fichiers soient en minuscules. Vous obtiendrez les erreurs "fichiers non trouvés" si vous ne le faites pas. | |
| 54 | 98 | ||
| 55 | 99 | #### Sources Delphi VCL, Kylix CLX dans Lazarus | |
| 56 | 100 | ||
| 57 | - | ||
| 101 | + | En convertissant des sources Delphi/Kylix, il est souvent utile de trouver des déclarations pour voir ce qu'une fonction spécifique fait. L'EDI Lazarus peut analyser les sources Delphi/Kylix. Pour faire ceci il a besoin de quelques chemins de recherche et paramètres du compilateur. Vous pouvez facilement paramétrer ceci dans Configuration->Editeur des directives des outils de code...->Inserer un modèle | |
| 58 | 102 | ||
| 59 | 103 | ### Problèmes de conversion et solutions | |
| 60 | 104 | ||
| 61 | 105 | #### Fichier Delphi / Kylix équivalents dans Lazarus | |
| 62 | 106 | ||
| 63 | - | ||
| 64 | - | ||
| 65 | - | ||
| 66 | - | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 71 | - | ||
| 72 | - | ||
| 73 | - | ||
| 74 | - | ||
| 75 | - | ||
| 76 | - | ||
| 77 | - | ||
| 78 | - | ||
| 79 | - | ||
| 80 | - | ||
| 81 | - | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 86 | - | ||
| 87 | - | ||
| 88 | - | ||
| 89 | - | ||
| 90 | - | ||
| 91 | - | ||
| 92 | - | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 97 | - | ||
| 98 | - | ||
| 99 | - | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 104 | - | ||
| 105 | - | ||
| 106 | - | ||
| 107 | - | ||
| 108 | - | ||
| 109 | - | ||
| 110 | - | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 114 | - | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 121 | - | ||
| 122 | - | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 127 | - | ||
| 128 | - | ||
| 129 | - | ||
| 130 | - | ||
| 131 | - | ||
| 132 | - | ||
| 133 | - | ||
| 107 | + | Delphi / Kylix | Description | Lazarus | Description | |
| 108 | + | ---|---|---|--- | |
| 109 | + | .pas .dfm/.xfm, .dcu/.dpu, .dpr(Code source du projet), .res, .dof/.kof \--- \--- \--- | Fichier source Delphi, Fiche Delphi, Unité compilée Delphi, Projet Delphi, Fichier de ressource Windows, Fichier d'options Delphi | .pas, .pp .lfm, .o, .lpr \--- \--- .lrs, .lpi(Fichier de projet), .ppu | Fichier unité Pascal, Fichier de donnée de fiche, Fichier d'unité compilée, Fichier de projet, Fichier de ressource, Fichier d'options du projet, Fichier de ressource de Lazarus, Fichier d'information de projet Lazarus, Fichier de description d'unité de FPC | |
| 110 | + | ||
| 111 | + | Ainsi, un fichier .dcu de Delphi corresponds grossièrement aux fichiers FPC .o et .ppu dans un seul fichier. Le .ppu est principalement la partie entête (interface), le .o principalement la partie implementation. Les principales exceptions sont les fonctions en-ligne qui dans la forme à insérer sont dans le .ppu. | |
| 134 | 112 | ||
| 135 | 113 | #### Convertir les projets/fiches/unités Delphi vers Lazarus | |
| 136 | 114 | ||
| 137 | - | ||
| 115 | + | Renommez ou copiez le fichier .dpr vers un fichier .lpr. Mettre en commentaire ou enlevez la directive {$R *.res} et ajouter une directive {$mode delphi}{$H+} ou {$mode objfpc}{$H+} au fichier .lpr. L'IDE Lazarus peut vous assister dans cette conversion à travers l'item du menu outils "Convertir un projet Delphi en projet Lazarus...". Il demande un fichier .dpr (projet Delphi) et le convertit en .lpr; en outre, il crée le fichier .lpi et convertit toutes les unités . | |
| 138 | 116 | ||
| 139 | - | ||
| 117 | + | Beaucoup de fiches existantes de Delphi peuvent être converties pour fonctionner avec Lazarus en employant le convertisseur de fiche .dfm vers .lfm intégré de l'IDE. Il peut être trouvé sous le menu outils à l'item "Convertir un fichier DFM en LFM...". Faire appel à la boite de dialogue fichier, sélectionnez le(s) fichier(s) dfm et le convertisseur fera le reste . | |
| 140 | 118 | ||
| 141 | - | ||
| 119 | + | Si vous devez convertir l'unité entière (avec ou sans une fiche), Lazarus inclut également un item intégré "Convertir une unité Delphi en unité Lazarus..." qui fera ce qui suit pour vous - | |
| 142 | 120 | ||
| 143 | - | ||
| 144 | - | ||
| 145 | - | ||
| 146 | - | ||
| 147 | - | ||
| 148 | - | ||
| 149 | - | ||
| 150 | - | ||
| 151 | - | ||
| 121 | + | 1. fixe le cas des noms de fichier include et des sections uses. | |
| 122 | + | 2. converti les fichiers .dfm vers les fichiers .lfm (actuellement sans contrôler le contenu, juste le format) | |
| 123 | + | 3. crée un fichier vide .lrs (le contenu sera créé plus tard ) | |
| 124 | + | 4. Ajoute la directive {$mode delphi} | |
| 125 | + | 5. Remplace l'unité windows par LCLIntf | |
| 126 | + | 6. Ajoute l'unité LResources si nécessaire (c.-à-d. , si l'unité .lrs doit être utilisée; uses LResources peut être dans la partie implémentation ) | |
| 127 | + | 7. Enlève l'unité de variantes | |
| 128 | + | 8. Enlève la directive {$R *.dfm} | |
| 129 | + | 9. Ajoute la section d'initialisation et la directive {$i unit.lrs} | |
| 152 | 130 | ||
| 153 | - | ||
| 131 | + | Ceci permet la conversion rapide et facile de la plupart des unités du format Delphi au format Lazarus. Il ne fait aucun contrôle de validité, ou changements automatiques de syntaxe, aussi tout les changements de syntaxe que vous devez faire, les changements additionnels d'unité/de nom d'unité, ou les changements de fichier dfm/pas pour les contrôles/les différences de composants, doivent toujours être fait manuellement, bien que dans le temps quelques assistants(wizards) facilitant une partie de ceci, particulièrement la réparation des fiches converties(lfm), puissent devenir disponible . | |
| 154 | 132 | ||
| 155 | 133 | #### Choix du bon mode du compilateur | |
| 156 | 134 | ||
| 157 | - | ||
| 158 | - | ||
| 159 | - | ||
| 135 | + | Le compilateur [[Free Pascal/fr|Free Pascal]] supporte 5 modes Pascal différents. Par exemple TP pour turbo pascal, vous laisse compiler des unités en turbo pascal. Il y a également un mode de compatibilité DELPHI qui peut être choisi pour rendre le code existant plus facile à convertir. Lazarus préfère le mode OBJFPC, qui est presque égal au mode DELPHI, mais est moins ambigu que la syntaxe de Delphi. Voici les points importants : | |
| 160 | 136 | ||
| 161 | - | ||
| 137 | + | Le mode peut être choisi en ligne de commande ou au début de la source . Employer la ligne de commande a l'avantage , que vous n'avez pas besoin de changer la source, mais l'inconvénient , que les autres doivent être renseignés . | |
| 162 | 138 | ||
| 163 | - | ||
| 164 | - | ||
| 165 | - | ||
| 139 | + | La plupart des unités Delphi peuvent être compilées par le compilateur [[Free Pascal/fr|Free Pascal]] en ajoutant | |
| 140 | + | ``` | |
| 141 | + | {$IFDEF FPC} | |
| 142 | + | {$MODE DELPHI} | |
| 143 | + | {$ENDIF} | |
| 144 | + | ``` | |
| 166 | 145 | ||
| 167 | - | ||
| 146 | + | juste après le nom de l'unité . | |
| 168 | 147 | ||
| 169 | - | ||
| 148 | + | Pour plus de détails à propos des modes de [[Free Pascal/fr|Free Pascal]] voir la [Documentation de Free Pascal](<http://www.freepascal.org/docs-html/prog/progap4.html#progse62.html>) | |
| 170 | 149 | ||
| 171 | 150 | #### Considérations sur les logiciels multiplate-formes | |
| 172 | 151 | ||
| 173 | - | ||
| 174 | - | ||
| 175 | - | ||
| 176 | - | ||
| 152 | + | * L'assembleur inline est toujours un problème parce qu'il liera le code à l'architecture Intel. Quelques développeurs font des prototypes d'algorithme en Pascal et utilisent la directive IFDEF avec leur assembleur optimisé. Heureusement TurboPower a fait ceci dans de nombreux endroits avec leur code . Si c'est le cas avec le paquet que vous convertissez , remettez la directive sur Pascal. | |
| 153 | + | * Ne pas mettre en référence des endroits de mémoire spécifique comme le secteur de données du BIOS. Découvrez ce dont le code a besoin et essayez de trouver une alternative multiplate-forme . | |
| 154 | + | * Ne pas faire les tours spécifiques du processeur (comme employer le compteur temporel d'Intel (time stamp counter)) sans insérer votre code dans une directive IFDEF pour la plate-forme que le code nécessite ... et fournissant une alternative pour des environnements qui n'ont pas les possibilités matérielles . | |
| 155 | + | * Si vous avez besoin de quelque code spécifique au système d'exploitation(OS) , alors vous pouvez employer la directive IFDEF. Voir ci-dessous pour une liste des macros . | |
| 177 | 156 | ||
| 178 | 157 | #### Les variables utiles pour le compilateur | |
| 179 | 158 | ||
| 180 | - | ||
| 181 | - | ||
| 182 | - | ||
| 159 | + | Pour écrire du code, qui se comporte sur divers systèmes différemment, vous pouvez employer les directives {$IFDEF Name}. | |
| 183 | 160 | ||
| 184 | - | ||
| 161 | + | * {$IfDef LCL} | |
| 185 | 162 | ||
| 186 | - | ||
| 163 | + | Cette variable est définie en utilisant le paquet LCL. Utile pour écrire du code qui fonctionne avec la bibliothèque LCL et Delphi. | |
| 187 | 164 | ||
| 188 | - | ||
| 165 | + | * {$IfDef LCLGtk}, {$IfDef LCLWin32}, {$IfDef LCLQt}, ... | |
| 189 | 166 | ||
| 190 | - | ||
| 167 | + | Cette variable est définie en utilisant le paquet LCL et le jeux de composants spécifique est actuellement employé. Utile pour écrire du code qui fonctionne avec la bibliothèque LCL sur une plate-forme spécifique. | |
| 191 | 168 | ||
| 192 | - | ||
| 169 | + | * {$IfDef FPC} | |
| 193 | 170 | ||
| 194 | - | ||
| 171 | + | Cette variable est définie, en utilisant le compilateur FPC. Utile pour écrire du code, qui fonctionne avec FPC et Delphi. | |
| 195 | 172 | ||
| 196 | - | ||
| 173 | + | * {$IfDef Unix}, {$IfDef Win32}, ... | |
| 197 | 174 | ||
| 198 | - | ||
| 199 | - | ||
| 200 | - | ||
| 175 | + | Défini par FPC pour le système d'exploitation cible courant. Delphi définit "Linux", "Win32" et "MSWindows". [[Free Pascal/fr|Free Pascal]] s'exécute sur beaucoup plus de plate-formes et ainsi on lui recommande d'employer l'item le plus courant. Par exemple "Unix" est défini pour Linux, FreeBSD, NetBSD et OpenBSD, là où Lazarus s'exécute déjà . Utilisez | |
| 176 | + | ``` | |
| 177 | + | {$IfDef Linux} | |
| 178 | + | {$Define Unix} | |
| 179 | + | {$EndIf} | |
| 180 | + | ``` | |
| 201 | 181 | ||
| 202 | - | ||
| 182 | + | pour contourner ceci pour Kylix . | |
| 203 | 183 | ||
| 204 | - | ||
| 184 | + | Pour plus de détails voir la [Documentation de Free Pascal](<http://www.freepascal.org/docs-html/prog/prog.html#QQ2-23-21>). **Texte gras** | |
| 205 | 185 | ||
| 206 | 186 | #### 32bit / 64 bit support | |
| 207 | 187 | ||
| 208 | - | ||
| 209 | - | ||
| 210 | - | ||
| 188 | + | Les pointeurs en 64bit demande 8 octets au lieu de 4 en 32bit. Le type 'Integer' demeure en 32bit pour compatibilité. Cela signifie que vous ne pouvez plus forcer les pointeurs en Integer et revenir en arrière. FPC définit deux nouveaux types : PtrInt and PtrUInt. PtrInt est une entier 32bit signé dans les plates-formes 32bit et un entier signé 64bit dans les plate-formes 64bit. La même chose avec PtrUInt mais en prenant des entiers non signés. Utilisez ce code qui devrait tourner pour Delphi et FPC : | |
| 189 | + | ``` | |
| 211 | 190 | {$IFNDEF FPC} | |
| 212 | - | ||
| 213 | - | ||
| 214 | - | ||
| 215 | - | ||
| 191 | + | type | |
| 192 | + | PtrInt = integer; | |
| 193 | + | PtrUInt = cardinal; | |
| 194 | + | {$ENDIF} | |
| 216 | 195 | ``` | |
| 217 | 196 | ||
| 218 | - | ||
| 197 | + | Remplacer tous les **integer(SomePointerOrObject)** par **PtrInt(SomePointerOrObject)**. | |
| 219 | 198 | ||
| 220 | - | ||
| 199 | + | Pour plus d'information, voir [[Multiplatform Programming Guide/fr|Guide de programmation Multi plate-forme]]. | |
| 221 | 200 | ||
| 222 | 201 | #### Trouver un identificateur manquant | |
| 223 | 202 | ||
| 224 | - | ||
| 225 | - | ||
| 226 | - | ||
| 203 | + | Il y a des différences dans la façon dont la bibliothèque LCL est organisée en comparaison avec la bibliothèque VCL de Delphi . Si vous obtenez une erreur "not found" du compilateur au sujet d'une classe ou d'un identificateur important, les chances sont bonnes qu'il/elle soit dans une unité différente. Une correspondance complète peut être trouvée en utilisant la commande grep avec le sous répertoire lazarus/docs/xml ou lcl. | |
| 227 | 204 | ||
| 228 | - | ||
| 205 | + | Par exemple la classe tbutton utilisée généralement donne typiquement une erreur dans le code Delphi parce qu'il est placé dans une unité appelée buttons.pp. La commande suivante trouve l'unité correcte très rapidement (dans le répertoire source de Lazarus ): | |
| 206 | + | ``` | |
| 207 | + | grep -in ' tbutton =' lcl/* | |
| 208 | + | ``` | |
| 229 | 209 | ||
| 230 | 210 | #### Différences principales d'unité entre Lazarus et Delphi | |
| 231 | 211 | ||
| 232 | 212 | **Please add to this topic!** | |
| 233 | 213 | ||
| 234 | - | ||
| 214 | + | * Windows->Interfaces, LCLIntf, LCLType, LCLProc, VCLGlobals, ...) | |
| 235 | 215 | ||
| 236 | - | ||
| 216 | + | Comme la bibliothèque LCL n'est pas spécifiquement dédiée à Windows, le code qui est dans l'unité Windows de Delphi pour accéder directement à l'API Win32, est placé dans des interfaces distinctes, lequel se situe dans l'unité LCLIntf. Gardez à l'esprit que Lazarus n'émule pas win32. Beaucoup de fonctions sont absentes et certaines ne fonctionnent pas comme leur homologues win32. Ces fonctions existent seulement pour la compatibilité avec Delphi et devrait seulement être employées pour un portage rapide. La bibliothèque LCL modifie plusieurs des types, ainsi souvent LCLType, et parfois VCLGlobals sont exigés. LCLProc contient également quelques fonctions ce qui peut être utile pour la manipulation de plus bas niveau comme "FreeThenNil", comme c'est le cas dans Delphi 5 (et plus). Utilisez "DeleteAmpersands" pour enlever des esperluètes additionnelles d'une chaîne de caractères pour les contrôles (& contre && etc). L'unité d'interfaces doit être incluse dans le fichier .lpr pour initialiser les jeux de composants graphiques appropriés . | |
| 237 | 217 | ||
| 238 | - | ||
| 218 | + | * Messages->LMessages | |
| 239 | 219 | ||
| 240 | - | ||
| 220 | + | Les messages TControl des événements callback de Win32 au format WM_CALLBACK et leurs structures associées sont généralement situés dans DELPHI dans l’unité Messages. Dans la LCL ce type de messages et leurs structures se trouvent dans Lmessages, avec en général le changement de « WM » en « LM ». Par exemple WM_MOUSEENTER devient LM_MOUSEENTER et TWMMouse devient TLMMouse. | |
| 241 | 221 | ||
| 242 | - | ||
| 222 | + | * Graphics, Controls->GraphTypes, GraphMath, Graphics, Controls | |
| 243 | 223 | ||
| 244 | - | ||
| 224 | + | Afin de simplifier les référencements multiples et circulaires d’unités quelques nouveaux types ont été définis dans une unité appelée GraphType regroupant des éléments qui, dans Delphi, sont placés dans Graphics ou Controls (par exemple le BvNone des Panels). Vous aurez donc parfois à l’utiliser. De même, GraphMath est une autre unité, qui bien qu’incompatible avec Delphi inclut d’autres fonctionnalités utiles. Elle prend en compte la précision TFloatPoint, diverses routines de Béziers, les lignes, les arcs, la surcharge d’opérateur telle que Point1=Point2+Point3 et la comparaison de Trects : If (Rect1=Rect2) then … | |
| 245 | 225 | ||
| 246 | - | ||
| 226 | + | * Mask->MaskEdit | |
| 247 | 227 | ||
| 248 | - | ||
| 228 | + | Afin de la nommer plus intelligement l’unité des TMaskEdit est nommée [MaskEdit] au lieu du nébuleux Mask de beaucoup de versions de Delphi. | |
| 249 | 229 | ||
| 250 | - | ||
| 230 | + | * StdCtrls->StdCtrls,Buttons | |
| 251 | 231 | ||
| 252 | - | ||
| 232 | + | Dans beaucoup de versions de Delphi, Tbutton est situé dans StdCtrls, alors que TSpeedButton et TBitBtn sont dans Buttons. Plus simplement, la LCL place tous les types de boutons dans Buttons, ce qui peut occasionnellement interrompre la traduction du code. Il est donc préférable de l’inclure systématiquement. | |
| 253 | 233 | ||
| 254 | 234 | #### Différences des Propriétés et methodes entre Delphi et FPC/LCL | |
| 255 | 235 | ||
| 256 | - | ||
| 257 | - | ||
| 236 | + | * TBitmap inclu un Canvas dans la LCL | |
| 237 | + | * [[Lazarus Faq|Lazarus_Faq#Why are TForm.ClientWidth§ClientHeight the same as TForm.Width.2FHeight]] | |
| 258 | 238 | ||
| 259 | 239 | #### Différence sémantique | |
| 260 | 240 | ||
| 261 | 241 | ##### Ordre d'évaluation des paramètres | |
| 262 | 242 | ||
| 263 | - | ||
| 243 | + | Delphi garantit que tous les paramètres sont évalués de la gauche vers la droite (sauf si une convention d'appel est précisée et spéficie autre chose, pour s'interfacer avec des routines C p.ex). FPC ne présente pas cette garantie et peut evaluer les paramètres dans n’importe quel ordre afin de générer un code optimal. | |
| 264 | 244 | ||
| 265 | 245 | ##### Procédures/Fonctions imbriquées en variables procédurales | |
| 266 | 246 | ||
| 267 | - | ||
| 247 | + | [voir l'article Wikipedia(en)](<https://en.wikipedia.org/wiki/Call_stack>) | |
| 268 | 248 | ||
| 269 | - | ||
| 249 | + | Delphi passe le pointeur de cadre de la procédure parent toujours sur la pile, et c'est à l'appelant de l'enlever à nouveau. Cela signifie qu'aussi longtemps que vous n'accédez pas aux variables de la procédure parent, vous pouvez passer l'adresse de la fonction imbriquée à une autre fonction qui peut alors l'appeler comme n'importe quelle variable procédurale. | |
| 270 | 250 | ||
| 271 | - | ||
| 251 | + | FPC de son côté, passe toujours le pointeur de cadre de la procédure parent comme un premier paramètre caché selon la convention d'appel employée, ce qui signifie que si vous appelez une procédure imbriquée comme une variable procédurale normale, tous les paramètres seront "décalés" d'une position. | |
| 272 | 252 | ||
| 273 | - | ||
| 253 | + | En bref, n'appelez pas de procédure imbriquée au moyen d'une variable procédurale. | |
| 274 | 254 | ||
| 275 | 255 | #### différence de syntaxe | |
| 276 | 256 | ||
| 277 | 257 | **SVP compléter cet article!** | |
| 278 | 258 | ||
| 279 | - | ||
| 259 | + | A cause de restrictions propres à FPC, des changements de synthaxe sont nécessaires. La directive {$Mode Delphi} autorise, comme Delphi, moins de rigueur. Aussi adaptez votre règles synthaxiques avec {$Mode ObjFPC} au plus vite, même si le code doit être partagé par Delphi et LCL. Certaines sont simplement de meilleurs pratiques et parfois parce que le mode Delphi n'est pas assez précis, ou dans quelques cas, un code acceptable pour Delphi ne fonctionne pas comme attendu avec FPC, même s'il pourrait compiler. | |
| 280 | 260 | ||
| 281 | - | ||
| 261 | + | À cette fin, même si tous ces éléments ne sont pas strictement requis, la liste suivante de changements devrait être considérée comme obligatoire : | |
| 282 | 262 | ||
| 283 | 263 | ##### Pour affecter un gestionnaire à un évènement vous devez le préfixer avec "@" | |
| 284 | 264 | ||
| 285 | - | ||
| 286 | - | ||
| 287 | - | ||
| 288 | - | ||
| 289 | - | ||
| 265 | + | Par exemple, pour assigner une procédure à un évènement "OnClick" d'un bouton : | |
| 290 | 266 | ||
| 291 | - | ||
| 292 | - | ||
| 293 | - | ||
| 294 | - | ||
| 295 | - | ||
| 296 | - | ||
| 297 | - | ||
| 267 | + | Delphi | FPC | |
| 268 | + | ---|--- | |
| 298 | 269 | ``` | |
| 299 | - | ||
| 300 | - | ||
| 301 | 270 | begin | |
| 302 | - | ||
| 303 | - | ||
| 304 | - | ||
| 305 | - | ||
| 306 | - | ||
| 271 | + | if not Assigned(MyButton.OnClick) then | |
| 272 | + | MyButton.OnClick:= SomeFunction; | |
| 273 | + | //@ not required | |
| 274 | + | //more code... | |
| 275 | + | end; | |
| 276 | + | ``` | |
| 277 | + | ||
| 278 | + | | | |
| 307 | 279 | ``` | |
| 308 | - | ||
| 309 | - | ||
| 280 | + | begin | |
| 281 | + | if not Assigned(MyButton.OnClick) then | |
| 282 | + | MyButton.OnClick:= @SomeFunction; | |
| 283 | + | //@ IS required | |
| 284 | + | //more code... | |
| 285 | + | end; | |
| 286 | + | ``` | |
| 287 | + | ||
| 288 | + | NB : cela n'est pas limité aux seuls événements, mais concerne tous les types procéduraux. | |
| 310 | 289 | ||
| 311 | 290 | ##### En appelant une variable procédure utilisez cette syntaxe : theprocname() | |
| 312 | 291 | ||
| 313 | - | ||
| 314 | - | ||
| 315 | - | ||
| 316 | - | ||
| 317 | - | ||
| 292 | + | En Delphi, il n'y a aucune différence entre un résultat de fonction et une variable. Par contre, il y en a une en FPC, ainsi pour appeler une fonction, même si elle n'a pas de paramètre, vous devez ajouter des parenthèses. Par exemple : | |
| 318 | 293 | ||
| 319 | - | ||
| 320 | - | ||
| 321 | - | ||
| 322 | - | ||
| 323 | - | ||
| 324 | - | ||
| 325 | - | ||
| 294 | + | Delphi | FPC | |
| 295 | + | ---|--- | |
| 326 | 296 | ``` | |
| 327 | - | ||
| 328 | - | ||
| 329 | 297 | With (SomeObject) do | |
| 330 | - | ||
| 331 | - | ||
| 332 | - | ||
| 333 | - | ||
| 334 | - | ||
| 298 | + | begin | |
| 299 | + | If Assigned(OnMyCallback) then | |
| 300 | + | OnMyCallback; | |
| 301 | + | //parenthesis not required | |
| 302 | + | end; | |
| 303 | + | ``` | |
| 304 | + | ||
| 305 | + | | | |
| 335 | 306 | ``` | |
| 336 | - | ||
| 307 | + | With (SomeObject) do | |
| 308 | + | begin | |
| 309 | + | If Assigned(OnMyCallback) then | |
| 310 | + | OnMyCallback(); | |
| 311 | + | //parenthesis required | |
| 312 | + | end; | |
| 313 | + | ``` | |
| 314 | + | ||
| 337 | 315 | ##### Déréférencement de pointeur d'enregistrement | |
| 338 | 316 | ||
| 339 | - | ||
| 340 | - | ||
| 341 | - | ||
| 342 | - | ||
| 343 | - | ||
| 317 | + | Dans Delphi , lorqu’on tente d’accéder aux membres d’un Record, il n’est pas nécessaire de faire la différence entre le pointeur du Record et le Record lui-même. FPC fait la distinction : | |
| 344 | 318 | ||
| 345 | - | ||
| 346 | - | ||
| 347 | - | ||
| 348 | - | ||
| 349 | - | ||
| 350 | - | ||
| 351 | - | ||
| 352 | - | ||
| 319 | + | Delphi | FPC | |
| 320 | + | ---|--- | |
| 353 | 321 | ``` | |
| 354 | - | ||
| 355 | - | ||
| 356 | 322 | Function GetSomeValue(ARecord: PMyRecord):Integer; | |
| 357 | - | ||
| 358 | - | ||
| 359 | - | ||
| 360 | - | ||
| 361 | - | ||
| 362 | - | ||
| 323 | + | begin | |
| 324 | + | If Assigned(ARecord) then | |
| 325 | + | Result:=ARecord.SomeValue | |
| 326 | + | else | |
| 327 | + | Result:=0; | |
| 328 | + | end; | |
| 329 | + | ``` | |
| 330 | + | ||
| 331 | + | | | |
| 363 | 332 | ``` | |
| 364 | - | ||
| 333 | + | Function GetSomeValue(ARecord: PMyRecord):Integer; | |
| 334 | + | begin | |
| 335 | + | If Assigned(ARecord) then | |
| 336 | + | Result:=ARecord^.SomeValue | |
| 337 | + | else | |
| 338 | + | Result:=0; | |
| 339 | + | end; | |
| 340 | + | ``` | |
| 341 | + | ||
| 365 | 342 | ##### Des parenthèses pour acceder aux chars d'une propriété string d'un objet | |
| 366 | 343 | ||
| 367 | - | ||
| 368 | - | ||
| 369 | - | ||
| 370 | - | ||
| 371 | - | ||
| 344 | + | Il est possible avec Delphi de traiter les propriétés comme des variables, même pour accéder directement aux valeurs particulières des Char d’un String. C’est impossible avec FPC, notamment lorsque des propriétés sont indexées (traitées comme des tableaux). Dans ce cas, la propriété appelée doit être comprise dans des parenthèses. Même si ce n’est pas toujours, le cas il est préférable de s’y astreindre systématiquement. Exemple : | |
| 372 | 345 | ||
| 373 | - | ||
| 346 | + | Delphi | FPC | |
| 347 | + | ---|--- | |
| 348 | + | ``` | |
| 374 | 349 | Type TSomeComponent=class(TComponent) | |
| 375 | - | ||
| 376 | - | ||
| 377 | - | ||
| 378 | - | ||
| 379 | - | ||
| 380 | - | ||
| 381 | - | ||
| 382 | - | ||
| 383 | - | ||
| 384 | - | ||
| 385 | - | ||
| 386 | - | ||
| 350 | + | //More code... | |
| 351 | + | Published | |
| 352 | + | Property MyString:String index 3 read GetMyString; | |
| 387 | 353 | //More code... | |
| 388 | - | ||
| 354 | + | End; | |
| 355 | + | ||
| 356 | + | var | |
| 357 | + | MyChar:char; | |
| 358 | + | begin | |
| 359 | + | If Length(MyString)>2 then | |
| 360 | + | //no parenthesis needed | |
| 361 | + | MyChar:= MyString[3]; | |
| 362 | + | //More code... | |
| 363 | + | end; | |
| 364 | + | ``` | |
| 365 | + | ||
| 366 | + | | | |
| 389 | 367 | ``` | |
| 390 | - | ||
| 391 | - | ||
| 392 | 368 | Type TSomeComponent=class(TComponent) | |
| 393 | - | ||
| 394 | - | ||
| 395 | - | ||
| 396 | - | ||
| 397 | - | ||
| 398 | - | ||
| 399 | - | ||
| 400 | - | ||
| 401 | - | ||
| 402 | - | ||
| 403 | - | ||
| 404 | - | ||
| 405 | 369 | //More code... | |
| 406 | - | ||
| 407 | - | ||
| 408 | - | ||
| 370 | + | Published | |
| 371 | + | Property MyString:String index 3 read GetMyString; | |
| 372 | + | //More code... | |
| 373 | + | End; | |
| 374 | + | ||
| 375 | + | var | |
| 376 | + | MyChar:char; | |
| 377 | + | begin | |
| 378 | + | If Length(MyString)>2 then | |
| 379 | + | //parenthesis sometimes needed | |
| 380 | + | MyChar:= (MyString)[3]; | |
| 381 | + | //More code... | |
| 382 | + | end; | |
| 383 | + | ``` | |
| 384 | + | ||
| 409 | 385 | ##### Ne confondez pas le pointeur et ce qui est pointé | |
| 410 | 386 | ||
| 411 | - | ||
| 412 | - | ||
| 413 | - | ||
| 414 | - | ||
| 415 | - | ||
| 387 | + | Parfois dans Delphi vous pouvez obtenir un pointeur, adressant un objet avec une valeur nulle. Bien que ce type de situation soit complexe, c’est très souvent le cas dans les grands paquets de composants afin de réduire les imbrications d’objets de différentes unités. Il est donc possible dans Delphi d’envoyer un pointeur nul à une fonction attendant un objet, sans se soucier du type d’objet associé au pointeur. En FPC vous ne devez pas confondre l’objet et son pointeur. La conversion de type est nécessaire. | |
| 416 | 388 | ||
| 417 | - | ||
| 389 | + | Exemple : | |
| 418 | 390 | ||
| 419 | - | ||
| 391 | + | Delphi | FPC | |
| 392 | + | ---|--- | |
| 393 | + | ``` | |
| 420 | 394 | Unit 1 | |
| 421 | - | ||
| 422 | - | ||
| 395 | + | Type | |
| 396 | + | TSomeObject=class(TComponent) | |
| 397 | + | //More code... | |
| 398 | + | End; | |
| 399 | + | ||
| 400 | + | Procedure DoSomething(Value: TSomeObject); | |
| 401 | + | Function GetSomeObject: TSomeObject; | |
| 402 | + | ||
| 403 | + | Unit 2 | |
| 404 | + | Type | |
| 405 | + | TSomeComponent=class(TComponent) | |
| 406 | + | //More code... | |
| 407 | + | Published SomeObject: Pointer; | |
| 408 | + | //More code... | |
| 409 | + | End; | |
| 410 | + | ||
| 411 | + | Application | |
| 412 | + | var | |
| 413 | + | MyComponent: TSomeComponent; | |
| 414 | + | begin | |
| 415 | + | MyComponent.SomeObject:=GetSomeObject; | |
| 423 | 416 | //More code... | |
| 424 | - | ||
| 425 | - | ||
| 426 | - | ||
| 427 | - | ||
| 428 | - | ||
| 429 | - | ||
| 430 | - | ||
| 431 | - | ||
| 432 | - | ||
| 433 | - | ||
| 434 | - | ||
| 435 | - | ||
| 436 | - | ||
| 437 | - | ||
| 438 | - | ||
| 439 | - | ||
| 440 | - | ||
| 441 | - | ||
| 442 | - | ||
| 443 | - | ||
| 444 | - | ||
| 417 | + | DoSomething(MyComponent.SomeObject); | |
| 418 | + | end; | |
| 419 | + | ``` | |
| 420 | + | ||
| 421 | + | | | |
| 445 | 422 | ``` | |
| 446 | - | ||
| 447 | - | ||
| 448 | 423 | Unit 1 | |
| 449 | - | ||
| 450 | - | ||
| 451 | - | ||
| 452 | - | ||
| 453 | - | ||
| 454 | - | ||
| 455 | - | ||
| 456 | - | ||
| 457 | - | ||
| 458 | - | ||
| 459 | - | ||
| 460 | - | ||
| 461 | - | ||
| 462 | - | ||
| 463 | - | ||
| 464 | - | ||
| 465 | - | ||
| 466 | - | ||
| 467 | - | ||
| 468 | - | ||
| 469 | - | ||
| 470 | - | ||
| 471 | - | ||
| 472 | - | ||
| 473 | - | ||
| 424 | + | Type | |
| 425 | + | TSomeObject=class(TComponent) | |
| 426 | + | //More code... | |
| 427 | + | End; | |
| 428 | + | ||
| 429 | + | Procedure DoSomething(Value: TSomeObject); | |
| 430 | + | Function GetSomeObject: TSomeObject; | |
| 431 | + | ||
| 432 | + | Unit 2 | |
| 433 | + | Type TSomeComponent=class(TComponent) | |
| 434 | + | //More code... | |
| 435 | + | Published SomeObject: Pointer; | |
| 436 | + | //More code... | |
| 437 | + | End; | |
| 438 | + | ||
| 439 | + | Application | |
| 440 | + | var | |
| 441 | + | MyComponent: TSomeComponent; | |
| 442 | + | begin | |
| 443 | + | MyComponent.SomeObject:=Pointer(GetSomeObject); | |
| 444 | + | //More code... | |
| 445 | + | DoSomething(TSomeObject(MyComponent.SomeObject)); | |
| 446 | + | end; | |
| 447 | + | ``` | |
| 448 | + | ||
| 474 | 449 | #### Ressources | |
| 475 | 450 | ||
| 476 | - | ||
| 477 | - | ||
| 478 | - | ||
| 451 | + |  **Remarque:** La section ci-dessous n'est peut-être pas nécessaire. Les dernières versions de Lazarus supportent directement les fichers .res. L'installateur Windows de Lazarus inclut un compilateur de ressource qui supporte les fichiers .rc. Sur Unix, assurez-vous que windres est installé ainsi vous pouvez utiliser les fichiers .rc. Se reporter à [[Lazarus Resources/fr|Ressources FPC]]. | |
| 479 | 452 | ||
| 480 | - | ||
| 481 | - | ||
| 453 | + | Les fichiers de ressource de Delphi sont spécifiques à Win32 et ne sont pas compatible avec Lazarus, donc vous devez les recréer et les compiler avec l'outil Lazres. Lazres peut être trouvé dans le sous-dossier lazarus/tools. Si vous avez téléchargé les sources de Lazarus, vous aurez besoin de le compiler. | |
| 482 | 454 | ||
| 483 | - | ||
| 455 | + | * cd lazarus/tools | |
| 456 | + | * make install | |
| 484 | 457 | ||
| 485 | - | ||
| 486 | - | ||
| 487 | - | ||
| 458 | + | Pour ajouter une ressource à votre application : | |
| 488 | 459 | ||
| 489 | - | ||
| 460 | + | * lazres myresource.lrs mypix.xpm anotherpix.xpm | |
| 461 | + | * Ajouter l'unité LResources à votre clause Uses | |
| 462 | + | * Incluez le fichier .lrs que vous avez créé sous le bloc d'initialisation | |
| 490 | 463 | ||
| 491 | - | ||
| 464 | + | Exemple: | |
| 465 | + | ``` | |
| 492 | 466 | function TForm1.LoadGlyph(const GlyphName: String): TBitMap; | |
| 493 | - | ||
| 494 | - | ||
| 495 | - | ||
| 496 | - | ||
| 497 | - | ||
| 498 | - | ||
| 499 | - | ||
| 500 | - | ||
| 501 | - | ||
| 502 | - | ||
| 503 | - | ||
| 504 | - | ||
| 505 | - | ||
| 506 | - | ||
| 467 | + | begin | |
| 468 | + | Result:= TPixmap.Create; | |
| 469 | + | Result.LoadFromLazarusResource(GlyphName); | |
| 470 | + | end; | |
| 471 | + | //More code... | |
| 472 | + | begin | |
| 473 | + | Speedbutton1.glyph:= LoadGlyph('mypix'); | |
| 474 | + | //More code... | |
| 475 | + | end; | |
| 476 | + | ||
| 477 | + | initialization | |
| 478 | + | {$I unit1.lrs} | |
| 479 | + | {$I myresource.lrs} | |
| 480 | + | end. | |
| 507 | 481 | ``` | |
| 508 | 482 | ||
| 509 | 483 | ### Une autre méthode pour convertir un projet Delphi ou Kylix vers Lazarus | |
| 510 | 484 | ||
| 511 | - | ||
| 512 | - | ||
| 513 | - | ||
| 485 | + | * Renommer ou copier tous les fichiers .dfm ou .xfm vers .lfm (les très anciennes versions de Delphi ne produisent pas de fichiers .dfm basés sur du texte. L'utilitaire convert est, si présent, dans le dossier \bin et doit être utilisé d'abord avec les .dfm) | |
| 486 | + | * Renommer ou copier le fichier .dpr en .lpr. | |
| 487 | + | * Apportez toutes les modifications nécessaires aux fichier .lpr. | |
| 514 | 488 | ||
| 515 | - | ||
| 516 | - | ||
| 517 | - | ||
| 489 | + | 1. Ajouter les directives {$mode delphi}{$H+} ou {$mode objfpc}{H+} | |
| 490 | + | 2. Ajouter 'Interfaces' à la clause Uses | |
| 491 | + | 3. Commenter ou supprimer {$R *.res} ou mettre en directive au besoin | |
| 518 | 492 | ||
| 519 | - | ||
| 493 | + | * Apporter les modifications nécessaires à tous les fichiers d'unités : | |
| 520 | 494 | ||
| 521 | - | ||
| 522 | - | ||
| 523 | - | ||
| 524 | - | ||
| 525 | - | ||
| 495 | + | 1. Ajouter la directive {$mode delphi}{$H+} ou {$mode objfpc}{H+} | |
| 496 | + | 2. Ajouter 'LResources' - à faire : vérifier si c'est toujours à faire pour les les nouvelles versions de Lazarus | |
| 497 | + | 3. Si la fiche contient des boutons, ajouter l'unité 'Buttons' à la clause Uses. | |
| 498 | + | 4. Commenter ou supprimer les directives {$R *.dfm} or {$R *.xfm} | |
| 499 | + | 5. Ajouter la section 'Initialization' à la fin de chaque fichier d'unité, et ajouter la directive {$I unitname.lrs} dedans | |
| 526 | 500 | ||
| 527 | - | ||
| 528 | - | ||
| 529 | - | ||
| 530 | - | ||
| 531 | - | ||
| 501 | + | * Sélectionner Projet->Nouveau projet depuis un fichier | |
| 502 | + | * Sélectionner le fichier .lpr | |
| 503 | + | * Dans la fenêtre 'Créer un nouveau projet', choisissez 'Application' | |
| 504 | + | * Construisez le projet et faites les corrections nécessaire plus loin pour obtenir une compilation propre. A ce moment, le fichier .lpi est généré automatiquement. vous pouvez obtenir des messages 'Error reading Form', cliquer sur 'Continuer le chargement' dans ce cas. | |
| 505 | + | * enregistrer tout, et vous avez un projet Lazarus :-) | |
| 532 | 506 | ||
| 533 | 507 | ## Obtenir de l'aide | |
| 534 | 508 | ||
| 535 | - | ||
| 536 | - | ||
| 537 | - | ||
| 538 | - | ||
| 539 | - | ||
| 540 | - | ||
| 541 | - | ||
| 542 | - | ||
| 543 | - | ||
| 544 | - | ||
| 545 | - | ||
| 509 | + | Si vous rencontrez un problème pendant la conversion que vous ne pouvez pas résoudre, il y a une large variété d'endroits où l'on peut obtenir de l'aide. | |
| 546 | 510 | ||
| 511 | + | ### Documentation | |
| 512 | + | ||
| 513 | + | --- | |
| 514 | + | Pour les problèmes purement Pascal Objet et FPC | Le meilleur endroit pour commencer est la [Documentation de Free Pascal](<http://www.freepascal.org/docs-html/>) par Michaël Van Canneyt et Florian Klämpfl. | |
| 515 | + | Pour les problème plus orientés vers Lazarus | La documentation du projet dans la base de connaissance Lazarus-CCR [[Main Page/fr|Page principale]] est le prochain endroit où vous regarderez. | |
| 516 | + | ||
| 547 | 517 | ### Support par les pairs | |
| 548 | 518 | ||
| 549 | - | ||
| 550 | - | ||
| 551 | - | ||
| 552 | - | ||
| 553 | - | ||
| 554 | - | ||
| 555 | - | ||
| 556 | - | ||
| 557 | - | ||
| 558 | - | ||
| 559 | - | ||
| 560 | - | ||
| 561 | - | ||
| 562 | - | ||
| 519 | + | Pour poser des questions à des experts ou des développeurs plus avancés : | |
| 520 | + | Mailing lists | You can post a question on any of the [mailing lists for the Free Pascal Compiler](<http://www.freepascal.org/maillist.html>) or the [FPC/Lazarus forums](<http://forum.lazarus.freepascal.org/index.php?action=forum>) where a lot of experts are subscribed. | |
| 521 | + | Si vous avez accès à IRC: | sur irc.freenode.net: [#fpc](<irc://irc.freenode.net/fpc>) pour FPC, ou [#lazarus-ide](<irc://irc.freenode.net/lazarus-ide>) pour Lazarus | |
| 522 | + | Forum francophone d'entraide : | sur [Developpez.com (Zone Pascal)](<http://www.developpez.net/forums/f21/autres-langages/pascal/>) | |
| 523 | + | ||
| 563 | 524 | ### Bases de connaissance | |
| 564 | 525 | ||
| 565 | - | ||
| 526 | + | Il existe des bases de recherche et de connaissances exceptionnelles en ligne qui peuvent également être d'une grande aide pour apprendre de nouvelles techniques et résoudre des problèmes: | |
| 566 | 527 | ||
| 567 | - | ||
| 568 | - | ||
| 569 | - | ||
| 528 | + | * Tamarack Associates exploite un [moteur de recherche](<http://codenewsfast.com/>) rapide particulièrement pour les archives Usenet de Borland. | |
| 529 | + | * Mer Systems Inc. fournit un [moteur de recherche](<http://www.mers.com/searchsite.html>) similaire | |
| 530 | + | * Une autre source d'information exceptionnelle ainsi qu'une capacité de [recherche](<http://www.efg2.com/Lab/search.htm>) sur site est Earl F. Glynn Computer Lab and Reference. | |
| 570 | 531 | ||
| 571 | 532 | ## Empaqueter et livrer votre composant | |
| 572 | 533 | ||
| 573 | 534 | ### Création d'un paquet Lazarus pour votre(vos) composant(s) | |
| 574 | 535 | ||
| 575 | - | ||
| 536 | + | La création d'un paquet rend plus aisé le processus d'installation du code que vous avez converti... surtout si vous fournisseez plus d'un composant. Mattias Gärtner a écrit une vue d'ensemble des [[Lazarus Packages/fr|paquets Lazarus]] qui devrait être lus préalablement à ce processus. | |
| 576 | 537 | ||
| 577 | 538 | ### Documentation | |
| 578 | 539 | ||
| 579 | - | ||
| 540 | + | L'objectif de ce site et le format wiki vise à rendre facile et rapide la production d'une documentation de niveau professionnelle. Le wiki rend aussi possible de voir le résultat de votre travail immédiatement et de faire tous les changements que vous voulez en temps réel. | |
| 580 | 541 | ||
| 581 | - | ||
| 542 | + | L'utilisation du wiki Lazarus-CCR pour créer une documentation de bel aspect est très simple. Si vous n'avez jamais utilisez de balisage auparavant, vous pouvez vous y familiariser à l'aide de l'aire d'entrainement [bac à sable](</index.php?title=Sand_Box/fr&action=edit&redlink=1> "Sand Box/fr \(page does not exist\)"). | |
| 582 | 543 | ||
| 583 | 544 | ### Création d'une page de livraison du code | |
| 584 | 545 | ||
| 585 | - | ||
| 546 | + | La livraison de la page de code contient l'information vitale sur votre composant qu'un téléchargeur aurait besoin de savoir, telle que la licence, les plates-formes prévues, le statut (alpha, bêta, stable...), d'où le télécharger, qui l'a écrit, est-ce qu'un support est disponible... etc. | |
| 586 | 547 | ||
| 587 | - | ||
| 548 | + | La procédure suivante vous permettra de créer une page de publication de code avec votre navigateur : | |
| 588 | 549 | ||
| 589 | - | ||
| 590 | - | ||
| 591 | - | ||
| 592 | - | ||
| 550 | + | * Aller vers le [Release new component](</index.php?title=Release_new_component/fr&action=edit&redlink=1> "Release new component/fr \(page does not exist\)") | |
| 551 | + | * Taper le noms de votre composant dans la boîte de texte et cliquer sur _Create Article_ | |
| 552 | + | * Remplir le modèle et enregistrer. | |
| 553 | + | * Editer la page [[Components and Code examples/fr|Components and Code examples]] et ajouter le lien que vous venez de créer vers la section "Released Components". enregistrer la page modifiée. | |
| 593 | 554 | ||
| 594 | 555 | ### Soumission de votre comoposant | |
| 595 | 556 | ||
| 596 | - | ||
| 557 | + | Si vous n'êtes pas le responsable de la livraison dans le projet, remonter votre composant vers le système de livraison de SourceForge et ajoutez-le à la liste des paquets de livraison. Autrement, envoyez-le à l'un des administrateur du projet ([Tom Lisjac](</User:Tom> "User:Tom") ou [Vincent Snijders](</User:Vincent> "User:Vincent")) et nous l'ajouterons au dépôt ("repository"). Avant que nous le déposions, vous devez créer une _Page de livraison de code_ pour décrire votre composant. Vous pouvez utiliser la page [Livraison d'un nouveau composant](</index.php?title=Release_new_component/fr&action=edit&redlink=1> "Release new component/fr \(page does not exist\)") pour commencer la création d'une telle page. | |
| 597 | 558 | ||
| 598 | - | ||
| 559 | + | Si vous pensez que vous aurez encore besoin de développer votre composant, vous pouvez le déposer dans SVN, comme cela vous aurez encore accès à lui. Si nous nous lassons de soumettre vos correctifs, nous vous donnerons l'accès en écriture au SVN, afin que vous puissiez valider vos correctifs vous-même. Pour plus de détails, voir l'[Utilisation du référentiel SVN de Lazarus-ccr](</index.php?title=Using_the_Lazarus-ccr_SVN_repository/fr&action=edit&redlink=1> "Using the Lazarus-ccr SVN repository/fr \(page does not exist\)"). | |
| 599 | 560 | ||
| 600 | 561 | --- | |
| 601 | - | ||
| 562 | + | *From the Free Pascal wiki, page "Code Conversion Guide/fr", as the Internet Archive kept it on 2025-02-15, last changed on 2020-02-11. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |