mirror of
https://github.com/openwrt/openwrt.git
synced 2024-12-25 00:11:13 +00:00
updated example Makefile and descriptions
SVN-Revision: 1443
This commit is contained in:
parent
738d99ea64
commit
ed7b62f564
@ -452,31 +452,31 @@ foo-compile: bar-compile
|
|||||||
<p>Finally, here's the hardest part. Create a file named
|
<p>Finally, here's the hardest part. Create a file named
|
||||||
<code>Makefile</code>. It will contain the <i>Makefile</i> rules that
|
<code>Makefile</code>. It will contain the <i>Makefile</i> rules that
|
||||||
are in charge of downloading, configuring, compiling and installing
|
are in charge of downloading, configuring, compiling and installing
|
||||||
the software. Below is an example that we will comment
|
the software. Below is an example that we will comment afterwards.</p>
|
||||||
afterwards.</p>
|
|
||||||
|
|
||||||
<pre>
|
<pre>
|
||||||
1 # $Id$
|
1 # $Id$
|
||||||
2 include $(TOPDIR)/rules.mk
|
2
|
||||||
3 PKG_NAME:=foo
|
3 include $(TOPDIR)/rules.mk
|
||||||
4 PKG_VERSION:=1.0
|
4
|
||||||
5 PKG_RELEASE:=1
|
5 PKG_NAME:=foo
|
||||||
6 PKG_MD5SUM:=4584f226523776a3cdd2fb6f8212ba8d
|
6 PKG_VERSION:=1.0
|
||||||
8 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
|
7 PKG_RELEASE:=1
|
||||||
9 PKG_SOURCE_URL:=http://www.foosoftware.org/downloads
|
8 PKG_MD5SUM:=4584f226523776a3cdd2fb6f8212ba8d
|
||||||
10 PKG_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION)
|
9
|
||||||
11 PKG_IPK:=$(PACKAGE_DIR)/$(PKG_NAME)_$(PKG_VERSION)-$(PKG_RELEASE)_$(ARCH).ipk
|
10 PKG_SOURCE_URL:=http://www.foosoftware.org/downloads
|
||||||
12 PKG_IPK_DIR:=$(PKG_DIR)/ipkg
|
11 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
|
||||||
|
12 PKG_CAT:=zcat
|
||||||
13
|
13
|
||||||
14 $(DL_DIR)/$(PKG_SOURCE):
|
14 PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION)
|
||||||
15 $(SCRIPT_DIR)/download.pl $(DL_DIR) $(PKG_SOURCE) $(PKG_MD5SUM) $(PKG_SOURCE_URL)
|
15 PKG_INSTALL_DIR:=$(PKG_BUILD_DIR)/ipkg-install
|
||||||
16
|
16
|
||||||
17 $(PKG_DIR)/.source: $(DL_DIR)/$(PKG_SOURCE)
|
17 include $(TOPDIR)/package/rules.mk
|
||||||
18 zcat $(DL_DIR)/$(PKG_SOURCE) | tar -C $(BUILD_DIR) $(TAR_OPTIONS) -
|
18
|
||||||
19 touch $(PKG_DIR)/.source
|
19 $(eval $(call PKG_template,FOO,foo,$(PKG_VERSION)-$(PKG_RELEASE),$(ARCH)))
|
||||||
20
|
20
|
||||||
21 $(PKG_DIR)/.configured: $(PKG_DIR)/.source
|
21 $(PKG_BUILD_DIR)/.configured: $(PKG_BUILD_DIR)/.prepared
|
||||||
22 (cd $(PKG_DIR); \
|
22 (cd $(PKG_BUILD_DIR); \
|
||||||
23 $(TARGET_CONFIGURE_OPTS) \
|
23 $(TARGET_CONFIGURE_OPTS) \
|
||||||
24 CFLAGS="$(TARGET_CFLAGS)" \
|
24 CFLAGS="$(TARGET_CFLAGS)" \
|
||||||
25 ./configure \
|
25 ./configure \
|
||||||
@ -485,36 +485,37 @@ foo-compile: bar-compile
|
|||||||
28 --build=$(GNU_HOST_NAME) \
|
28 --build=$(GNU_HOST_NAME) \
|
||||||
29 --prefix=/usr \
|
29 --prefix=/usr \
|
||||||
30 --sysconfdir=/etc \
|
30 --sysconfdir=/etc \
|
||||||
31 );
|
31 --with-bar="$(STAGING_DIR)/usr" \
|
||||||
32 touch $(PKG_DIR)/.configured;
|
32 );
|
||||||
33
|
33 touch $@
|
||||||
34 $(PKG_DIR)/$(PKG_NAME): $(PKG_DIR)/.configured
|
34
|
||||||
35 $(MAKE) CC=$(TARGET_CC) -C $(PKG_DIR)
|
35 $(PKG_BUILD_DIR)/.built:
|
||||||
36
|
36 rm -rf $(PKG_INSTALL_DIR)
|
||||||
37 $(PKG_IPK): $(PKG_DIR)/$(PKG_NAME)
|
37 mkdir -p $(PKG_INSTALL_DIR)
|
||||||
38 $(SCRIPT_DIR)/make-ipkg-dir.sh $(PKG_IPK_DIR) $(PKG_NAME).control $(PKG_VERSION)-$(PKG_RELEASE) $(ARCH)
|
38 $(MAKE) -C $(PKG_BUILD_DIR) \
|
||||||
39 $(MAKE) prefix=$(PKG_IPK_DIR)/usr -C $(PKG_DIR) install
|
39 $(TARGET_CONFIGURE_OPTS) \
|
||||||
40 rm -Rf $(PKG_IPK_DIR)/usr/man
|
40 install_prefix="$(PKG_INSTALL_DIR)" \
|
||||||
41 $(IPKG_BUILD) $(PKG_IPK_DIR) $(PACKAGE_DIR)
|
41 all install
|
||||||
42
|
42 touch $@
|
||||||
43 $(IPKG_STATE_DIR)/info/$(PKG_NAME).list: $(PKG_IPK)
|
43
|
||||||
44 $(IPKG) install $(PKG_IPK)
|
44 $(IPKG_FOO):
|
||||||
45
|
46 install -d -m0755 $(IDIR_FOO)/usr/sbin
|
||||||
46 prepare: $(PKG_DIR)/.source
|
47 cp -fpR $(PKG_INSTALL_DIR)/usr/sbin/foo $(IDIR_FOO)/usr/sbin
|
||||||
47 compile: $(PKG_IPK)
|
49 $(RSTRIP) $(IDIR_FOO)
|
||||||
48 install: $(IPKG_STATE_DIR)/info/$(PKG_NAME).list
|
50 $(IPKG_BUILD) $(IDIR_FOO) $(PACKAGE_DIR)
|
||||||
49 clean:
|
51
|
||||||
50 rm -rf $(PKG_DIR)
|
52 mostlyclean:
|
||||||
51 rm -f $(PKG_IPK)
|
53 make -C $(PKG_BUILD_DIR) clean
|
||||||
|
54 rm $(PKG_BUILD_DIR)/.built
|
||||||
</pre>
|
</pre>
|
||||||
|
|
||||||
<p>First of all, this <i>Makefile</i> example works for a single
|
<p>First of all, this <i>Makefile</i> example works for a single
|
||||||
binary software. For other software such as libraries or more
|
binary software. For other software such as libraries or more
|
||||||
complex stuff with multiple binaries, it should be adapted. Look at
|
complex stuff with multiple binaries, it should be adapted. Look at
|
||||||
the other <code>Makefile</code> files in the <code>package</code>
|
the other <code>Makefile</code> files in the <code>package/</code>
|
||||||
directory.</p>
|
directory.</p>
|
||||||
|
|
||||||
<p>At lines 3-12, a couple of useful variables are defined :</p>
|
<p>At lines 5-15, a couple of useful variables are defined:</p>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><code>PKG_NAME</code> : The package name, e.g. <i>foo</i>.</li>
|
<li><code>PKG_NAME</code> : The package name, e.g. <i>foo</i>.</li>
|
||||||
@ -523,45 +524,42 @@ foo-compile: bar-compile
|
|||||||
should be downloaded.</li>
|
should be downloaded.</li>
|
||||||
|
|
||||||
<li><code>PKG_RELEASE</code> : The release number that will be
|
<li><code>PKG_RELEASE</code> : The release number that will be
|
||||||
appended to the version number of your <i>ipkg</i> package.
|
appended to the version number of your <i>ipkg</i> package.</li>
|
||||||
|
|
||||||
<li><code>PKG_MD5SUM</code> : The md5sum of the software archive.
|
<li><code>PKG_MD5SUM</code> : The md5sum of the software archive.</li>
|
||||||
|
|
||||||
<li><code>PKG_SOURCE</code> : The name of the tarball of
|
|
||||||
your package on the download website of FTP site. As you can see
|
|
||||||
<code>PKG_NAME</code> and <code>PKG_VERSION</code> are used.</li>
|
|
||||||
|
|
||||||
<li><code>PKG_SOURCE_URL</code> : Space separated list of the HTTP
|
<li><code>PKG_SOURCE_URL</code> : Space separated list of the HTTP
|
||||||
or FTP sites from which the archive is downloaded. It must include the complete
|
or FTP sites from which the archive is downloaded. It must include the complete
|
||||||
path to the directory where <code>FOO_SOURCE</code> can be
|
path to the directory where <code>FOO_SOURCE</code> can be
|
||||||
found.</li>
|
found.</li>
|
||||||
|
|
||||||
<li><code>PKG_DIR</code> : The directory into which the software
|
<li><code>PKG_SOURCE</code> : The name of the tarball of
|
||||||
|
your package on the download website of FTP site. As you can see
|
||||||
|
<code>PKG_NAME</code> and <code>PKG_VERSION</code> are used.</li>
|
||||||
|
|
||||||
|
<li><code>PKG_CAT</code> : The tool needed for extraction of the
|
||||||
|
software archive.</li>
|
||||||
|
|
||||||
|
<li><code>PKG_BUILD_DIR</code> : The directory into which the software
|
||||||
will be configured and compiled. Basically, it's a subdirectory
|
will be configured and compiled. Basically, it's a subdirectory
|
||||||
of <code>BUILD_DIR</code> which is created upon decompression of
|
of <code>BUILD_DIR</code> which is created upon extraction of
|
||||||
the tarball.</li>
|
the tarball.</li>
|
||||||
|
|
||||||
<li><code>PKG_IPK</code> : The resulting <i>ipkg</i> package
|
<li><code>PKG_INSTALL_DIR</code> : The directory into the software
|
||||||
|
will be installed. It is a subdirectory of <code>PKG_BUILD_DIR</code>.</li>
|
||||||
|
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<p>Lines 14-15 defines a target that downloads the tarball from
|
<p>In Line 3 and 17 we include common variables and routines to simplify
|
||||||
the remote site to the download directory
|
the process of ipkg creation. It includes routines to download, verify
|
||||||
(<code>DL_DIR</code>).</p>
|
and extract the software package archives.</p>
|
||||||
|
|
||||||
<p>Lines 17-19 defines a target and associated rules that
|
<p>Line 19 contains the magic line which automatically creates the
|
||||||
uncompress the downloaded tarball. As you can see, this target
|
ipkg for us.</p>
|
||||||
depends on the tarball file, so that the previous target (line
|
|
||||||
14-15) is called before executing the rules of the current
|
|
||||||
target. Uncompressing is followed by <i>touching</i> a hidden file
|
|
||||||
to mark the software has having been uncompressed. This trick is
|
|
||||||
used everywhere in Buildroot <i>Makefile</i> to split steps
|
|
||||||
(download, uncompress, configure, compile, install) while still
|
|
||||||
having correct dependencies.</p>
|
|
||||||
|
|
||||||
<p>Lines 21-32 defines a target and associated rules that
|
<p>Lines 21-33 defines a target and associated rules that
|
||||||
configures the software. It depends on the previous target (the
|
configures the software. It depends on the previous target (the
|
||||||
hidden <code>.source</code> file) so that we are sure the software has
|
hidden <code>.prepared</code> file) so that we are sure the software has
|
||||||
been uncompressed. In order to configure it, it basically runs the
|
been uncompressed. In order to configure it, it basically runs the
|
||||||
well-known <code>./configure</code>script. As we may be doing
|
well-known <code>./configure</code>script. As we may be doing
|
||||||
cross-compilation, <code>target</code>, <code>host</code> and
|
cross-compilation, <code>target</code>, <code>host</code> and
|
||||||
@ -571,41 +569,21 @@ foo-compile: bar-compile
|
|||||||
filesystem. Finally it creates a <code>.configured</code> file to
|
filesystem. Finally it creates a <code>.configured</code> file to
|
||||||
mark the software as configured.</p>
|
mark the software as configured.</p>
|
||||||
|
|
||||||
<p>Lines 34-35 defines a target and a rule that compiles the
|
<p>Lines 35-42 defines a target and a rule that compiles the
|
||||||
software. This target will create the binary file in the
|
software. This target will create the binary file in the
|
||||||
compilation directory, and depends on the software being already
|
compilation directory, and depends on the software being already
|
||||||
configured (hence the reference to the <code>.configured</code>
|
configured (hence the reference to the <code>.configured</code>
|
||||||
file). It basically runs <code>make</code> inside the source
|
file). Afterwards it installs the resulting binary into the
|
||||||
directory.</p>
|
<code>PKG_INSTALL_DIR</code>. It basically runs
|
||||||
|
<code>make install</code> inside the source directory.</p>
|
||||||
|
|
||||||
<p>Lines 37-41 defines a target and associated rules that create
|
<p>Lines 44-50 defines a target and associated rules that create
|
||||||
the <i>ipkg</i> package which can optionally be embedded into
|
the <i>ipkg</i> package, which can optionally be embedded into
|
||||||
the resulting firmware image. It depends on the binary file in
|
the resulting firmware image. It manually installs all files you
|
||||||
the source directory, to make sure the software has been compiled.
|
want to integrate in your resulting ipkg. <code>RSTRIP</code> will
|
||||||
It uses the make-ipkg-dir.sh script, which will create the ipkg
|
recursevily strip all binaries and libraries.
|
||||||
build directory for your package, copy your control file into
|
|
||||||
that directory and add version and architecture information.
|
|
||||||
Then it calls the <code>install</code> target of the
|
|
||||||
software <code>Makefile</code> by passing a <code>prefix</code>
|
|
||||||
argument, so that the <code>Makefile</code> doesn't try to install
|
|
||||||
the software inside host <code>/usr</code> but inside target
|
|
||||||
<code>/usr</code>. After the installation, the
|
|
||||||
<code>/usr/man</code> directory inside the target filesystem is
|
|
||||||
removed to save space.
|
|
||||||
Finally <code>IPKG_BUILD</code> is called to create the package.</p>
|
Finally <code>IPKG_BUILD</code> is called to create the package.</p>
|
||||||
|
|
||||||
<p>Line 43 and 44 define the installation target of your package,
|
|
||||||
which will embed the software into the target filesystem.</p>
|
|
||||||
|
|
||||||
<p>Lines 46-51 define the main targets that the Makefile in the
|
|
||||||
<code>package</code> dir calls.
|
|
||||||
<ul>
|
|
||||||
<li><code>prepare</code> : Download and unpack the source</li>
|
|
||||||
<li><code>compile</code> : Compile the source and create the package</li>
|
|
||||||
<li><code>install</code> : Embed the package into the target filesystem</li>
|
|
||||||
<li><code>clean</code> : Remove all the files created by the build process</li>
|
|
||||||
</ul></p>
|
|
||||||
|
|
||||||
<h3>Conclusion</h3>
|
<h3>Conclusion</h3>
|
||||||
|
|
||||||
<p>As you can see, adding a software to buildroot is simply a
|
<p>As you can see, adding a software to buildroot is simply a
|
||||||
@ -614,12 +592,14 @@ foo-compile: bar-compile
|
|||||||
the software.</p>
|
the software.</p>
|
||||||
|
|
||||||
<p>If you package software that might be useful for other persons,
|
<p>If you package software that might be useful for other persons,
|
||||||
don't forget to send a patch to OpenWrt developers !</p>
|
don't forget to send a patch to OpenWrt developers!
|
||||||
|
Use the mail address: patches@openwrt.org
|
||||||
|
</p>
|
||||||
|
|
||||||
<h2><a name="links" id="links"></a>Resources</h2>
|
<h2><a name="links" id="links"></a>Resources</h2>
|
||||||
|
|
||||||
<p>To learn more about OpenWrt Buildroot you can visit this
|
<p>To learn more about OpenWrt you can visit this website:
|
||||||
website: <a href="http://openwrt.org/">http://openwrt.org/</a></p>
|
<a href="http://openwrt.org/">http://openwrt.org/</a></p>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
</body>
|
</body>
|
||||||
|
Loading…
Reference in New Issue
Block a user