Quels sont Makefile.am et Makefile.in?

Question

Ces deux fichiers sont principalement utilisés dans les projets open source.

À quoi servent-ils et comment fonctionnent-ils?

Answer 1

Makefile.am est un fichier défini par le programmeur et est utilisé par automake pour générer le fichier Makefile.in (le .am signifie automake). Le script configure généralement vu dans les sources tar est utilisé pour générer un fichier Makefile.

Le configure script lui-même est généré à partir d'un fichier défini par le programmeur nommé configure.ac ou configure.in (déprécié). Je préfère .ac (pour autoconf) car cela le différencie des fichiers Makefile.in générés, et de cette manière je peux avoir des règles telles que make dist-clean qui exécute rm -f *.in. Comme c'est un fichier généré, il n'est pas généralement stocké dans un système de révision tel que Git, SVN, Mercurial ou CVS, plutôt le fichier .ac le serait.

En savoir plus sur GNU Autotools. Lire sur make et Makefile d'abord, puis apprendre sur automake, autoconf, libtool, etc.

Answer 2

Exemple simple

Honteusement adapté de : http://www.gnu.org/software/automake/manual/html_node/Creating-amhello.html et testé sur Ubuntu 14.04 Automake 1.14.1.

Makefile.am

SUBDIRS = src
dist_doc_DATA = README.md

README.md

Some doc.

configure.ac

AC_INIT([automake_hello_world], [1.0], [bug-automake@gnu.org])
AM_INIT_AUTOMAKE([-Wall -Werror foreign])
AC_PROG_CC
AC_CONFIG_HEADERS([config.h])
AC_CONFIG_FILES([
 Makefile
 src/Makefile
])
AC_OUTPUT

src/Makefile.am

bin_PROGRAMS = autotools_hello_world
autotools_hello_world_SOURCES = main.c

src/main.c

#include 
#include 

int main (void) {
  puts ("Hello world from " PACKAGE_STRING);
  return 0;
}

Utilisation

autoreconf --install
mkdir build
cd build
../configure
make
sudo make install
autotools_hello_world
sudo make uninstall

Ceci affiche :

Hello world from automake_hello_world 1.0

Notes

• autoreconf --install génère plusieurs fichiers modèles qui devraient être suivis par Git, y compris Makefile.in. Il suffit de l'exécuter une seule fois.

• make install installe :

  • le binaire dans /usr/local/bin
  • README.md dans /usr/local/share/doc/automake_hello_world

Sur GitHub pour que vous puissiez l'essayer.

Answer 3

Le DÉVELOPPEUR exécute autoconf et automake:

1. autoconf - crée le script configure exécutable
   (dont l'installateur lancera plus tard pour générer le Makefile)

• ‘autoconf’ est un processeur de macros.
• Il convertit configure.ac, qui est un script shell utilisant des instructions de macro, en configure, un script shell complet.

2. automake - crée le fichier de données Makefile.in exécutable
   (dont configure lira plus tard pour générer le Makefile)

• Automake aide à créer des Makefiles portables et conformes aux normes GNU.
• ‘automake’ crée des Makefile.in complexes à partir de simples Makefile.am

---

L'INSTALLATEUR exécute configure, make et sudo make install:

./configure       # Crée le  Makefile        (à partir de     Makefile.in).  
make              # Crée l'application (à partir du Makefile nouvellement créé).  

sudo make install # Installe l'application 
                  #   En général, par défaut ses fichiers sont installés dans /usr/local

---

---

SYNTAXE DES ENTRÉES/SORTIES

La notation ci-dessous est approximativement : entrées --> programmes --> sorties

Le DÉVELOPPEUR exécute ces commandes :

configure.ac -> autoconf -> configure (script) --- (*.ac = autoconf)
configure.in --> autoconf -> configure (script) --- (configure.in obsolète. Utiliser configure.ac)

Makefile.am -> automake -> Makefile.in ----------- (*.am = automake)

L'INSTALLATEUR exécute ces commandes :

Makefile.in -> configure -> Makefile (*.in = input file)

Makefile -> make ----------> (place le nouveau logiciel dans vos téléchargements ou répertoire temporaire)
Makefile -> make install -> (place le nouveau logiciel dans les répertoires système)

---

"autoconf est un ensemble extensible de macros M4 qui produisent des scripts shell pour configurer automatiquement des packages de code source logiciel. Ces scripts peuvent adapter les packages à de nombreux types de systèmes de type UNIX sans intervention manuelle de l'utilisateur. Autoconf crée un script de configuration pour un package à partir d'un fichier modèle qui liste les fonctionnalités du système d'exploitation que le package peut utiliser, sous forme d'appels de macros M4."

"automake est un outil pour générer automatiquement des fichiers Makefile.in conformes aux normes de codage GNU. Automake nécessite l'utilisation d'Autoconf."

Manuels :

• GNU AutoTools (Le manuel définitif sur ce sujet)

• m4 (utilisé par autoconf)

• autoconf

• automake

Tutoriels en ligne gratuits :

• Using GNU Autotools

---

Exemple :

Le principal configure.ac utilisé pour construire LibreOffice comporte plus de 12 000 lignes de code, (mais il y a aussi 57 autres fichiers configure.ac dans les sous-dossiers.)

Mon configure généré à partir de cela comporte plus de 41 000 lignes de code.

Et tandis que le Makefile.in et le Makefile ne comportent tous les deux que 493 lignes de code. (Mais, il y a aussi 768 autres Makefile.in dans les sous-dossiers.)

Answer 4

référence :

Makefile.am -- un fichier d'entrée utilisateur pour automake

configure.in -- un fichier d'entrée utilisateur pour autoconf

---

autoconf génère configure à partir de configure.in

automake génère Makefile.in à partir de Makefile.am

configure génère Makefile à partir de Makefile.in

Par exemple :

$]
configure.in Makefile.in
$] sudo autoconf
configure configure.in Makefile.in ... 
$] sudo ./configure
Makefile Makefile.in