build: Add download capability for external packages
authorGeorge Joseph <gjoseph@digium.com>
Tue, 2 Aug 2016 01:55:33 +0000 (19:55 -0600)
committerGeorge Joseph <gjoseph@digium.com>
Tue, 6 Sep 2016 15:39:28 +0000 (10:39 -0500)
commit6caf6bcdad003237725bf458a26db8ff74120508
treef4179468444b56cb851f3b4a03f3ee5c0840ebd5
parentfe806ba08b550d560fa215d95c27c1852ec06d08
build: Add download capability for external packages

The DPMA and g729a, silk, siren7 and siren14 codecs hosted at
http://downloads.digium.com/pub/telephony/ are now listed in the
"External" sections of the "Resource Modules" and "Codec Translators"
pages in menuselect.  Any that are selected will automatically be
downloaded and installed when "make install" is run.  Their LICENSE and
README (if avaialble) files will be installed to
ASTVARLIBDIR/documentation/thirdparty/<product_name>.

Example use with codecs:

The codecs/codecs.xml file is a menuselect style xml file that lists
the codecs to be included.  Their support levels are 'external', which
triggers the download and install, and defaultenabled is no.  Also
because codec_g729a is actually in a directory named codec_g729 on the
download server, the newly added 'member_data' element is used to
override the default of the directory name being the package name.  You
can use the 'directory_name' attribute to keep default base URL
(http://downloads.digium.com/pub/telephony/) but use the new directory,
or you use the 'remote_url' attribute to specify a full URL to the
download directory.  In this case, you must still follow the same
subdirectory naming conventions as that used for the packages located
at 'http://downloads.digium.com/pub/telephony'.

A new configure option '--with-externals-cache' was added and like
'--with-sounds-cache' it allows the installer to cache tarballs so
they're not downloaded every time.

To assist with the download and install process, each external package
now has a manifest.xml file that, among other things, contains a package
version and checksums for each file in the tarball.  The manifest is
saved to both the cache directory and ASTMODDIR and together with the
manifest.xml on the downloads site, tells the install scripts whether
a download and/or update is needed.

bash and xmlstarlet are required for downloader operation.  If they're
not installed, the external items in menuselect will be unavailable.

Change-Id: Id3dcf1289ffd3cb0bbd7dfab3cafbb87be60323a
12 files changed:
CHANGES
Makefile
Makefile.moddir_rules
build_tools/download_externals [new file with mode: 0755]
build_tools/list_valid_installed_externals [new file with mode: 0755]
build_tools/make_version
build_tools/menuselect-deps.in
codecs/codecs.xml [new file with mode: 0644]
configure
configure.ac
makeopts.in
res/res.xml [new file with mode: 0644]