2 # This script manages external libraries
4 # Some methods are added to manage external packages:
5 # 'PrepareLib': Checks the existence of an external library, if it
6 # doesn't exist, calls the script user provided to download(if required)
7 # and build the source code of the external library or notify user to
9 # 'Download': Download package from specify URL
10 # 'UnpackAll': Unpack the package
11 # 'Configure': Execute specify script(configure, bootstrap etc)
12 # 'InstallHeadFile': Install head files
13 # 'InstallLib': Install library binaries(.so, .a etc)
15 # By default, assume the script for an exteranl library is:
16 # <src_dir>/extlibs/<libname>/SConscript
18 # Note: After the external library is built:
19 # Head files should be installed to <src_dir>/deps/<target_os>/include
20 # lib(e.g .so, .a) should be installed to <src_dir>/deps/<target_os>/lib/<arch>
24 import urllib2, urlparse
29 target_os = env.get('TARGET_OS')
30 target_arch = env.get('TARGET_ARCH')
31 rd_mode = env.get('RD_MODE')
33 # for android, doesn't distinguish 'armeabi-v7a-hard' and 'armeabi-v7a' library
34 if target_os == 'android':
35 if target_arch == 'armeabi-v7a-hard':
36 target_arch = 'armeabi-v7a'
37 env.AppendUnique(CCFLAGS = ['-D__JAVA__'])
39 if target_os == 'darwin':
40 env.AppendUnique(CPPPATH = ['/usr/local/include'])
41 env.AppendUnique(LIBPATH = ['/usr/local/lib'])
43 if env.get('BUILD_JAVA') == 'ON' and target_os != 'android':
44 if env.get('JAVA_HOME') != None:
45 env.AppendUnique(CCFLAGS = ['-D__JAVA__'])
46 env.AppendUnique(CPPPATH = [
47 env.get('JAVA_HOME') + '/include',
48 env.get('JAVA_HOME') + '/include/' + target_os
51 raise SCons.Errors.StopError( 'BUILD_JAVA is ON, but JAVA_HOME is not set.')
54 # External library include files are in <src_dir>/deps/<target_os>/include
55 # the library binaries are in <src_dir>/deps/<target_os>/lib/<arch>
56 if target_os not in ['windows']:
57 env.AppendUnique(CPPPATH = [os.path.join(env.get('SRC_DIR'), 'deps', target_os, 'include')])
58 env.AppendUnique(LIBPATH = [os.path.join(env.get('SRC_DIR'), 'deps', target_os, 'lib', target_arch)])
60 # Check whether a library exists, if not, notify user to install it or try to
61 # download the source code and build it
62 # @param libname - the name of the library try to prepare
63 # @param lib - the lib(.so, .a etc) to check (a library may include more then
64 # one lib, e.g. boost, includes boost_thread, boost_system ...
65 # @param path - the directory of the library building script, if it's not set,
66 # by default, it's <src_dir>/extlibs/<libname>/
67 # @param script - the building script, by default, it's 'SConscript'
69 def __prepare_lib(ienv, libname, lib = None, path = None, script = None):
71 if p_env.GetOption('clean') or p_env.GetOption('help'):
74 conf = Configure(p_env)
78 if not conf.CheckLib(lib):
82 dir = os.path.join(env.get('SRC_DIR'), 'extlibs', libname)
84 # Execute the script to download(if required) and build source code
86 st = os.path.join(dir, script)
88 st = os.path.join(dir, 'SConscript')
90 if os.path.exists(st):
93 if target_os in ['linux', 'darwin', 'tizen']:
94 print 'Don\'t find library(%s), please intall it, exit ...' % libname
96 print 'Don\'t find library(%s) and don\'t find the process script (%s), exit ...' % (libname, st)
101 # Run configure command (usually it's done before build a library)
102 def __configure(env, cwd, cmd) :
103 print "Configuring using [%s/%s] ..." % (cwd, cmd)
104 # build it now (we need the shell, because some programs need it)
105 devnull = open(os.devnull, "wb")
106 handle = subprocess.Popen(cmd, shell=True, cwd=cwd, stdout=devnull)
108 if handle.wait() <> 0 :
109 raise SCons.Errors.BuildError( "Run configuring script [%s]" % (cmd) )
111 # Download from URL 'url', will save as 'target'
112 def __download(ienv, target, url) :
113 if os.path.exists(target) :
117 print "Download %s from %s" % (target, url)
118 print "Downloading ..."
119 stream = urllib2.urlopen(url)
120 file = open(target, 'wb')
121 file.write(stream.read())
123 print "Download %s from %s complete" % (target, url)
125 except Exception, e :
126 raise SCons.Errors.StopError( '%s [%s]' % (e, url) )
128 # Install header file(s) to <src_dir>/deps/<target_os>/include
129 def __install_head_file(ienv, file):
130 return ienv.Install(os.path.join(env.get('SRC_DIR'), 'dep', target_os, target_arch, 'usr', 'include'), file)
132 # Install library binaries to <src_dir>/deps/<target_os>/lib/<arch>
133 def __install_lib(ienv, lib):
134 return ienv.Install(os.path.join(env.get('SRC_DIR'), 'dep', target_os, target_arch, 'usr', 'lib'), lib)
136 SConscript('tools/UnpackAll.py')
138 # tinycbor build/fetch
139 SConscript(os.path.join(env.get('SRC_DIR'), 'extlibs', 'tinycbor', 'SConscript'))
141 with_ra = env.get('WITH_RA')
143 SConscript(os.path.join(env.get('SRC_DIR'), 'extlibs', 'raxmpp', 'SConscript'))
145 with_ra_ibb = env.get('WITH_RA_IBB')
147 SConscript(os.path.join(env.get('SRC_DIR'), 'extlibs', 'wksxmppxep', 'SConscript'))
150 env.AddMethod(__prepare_lib, "PrepareLib")
151 env.AddMethod(__configure, "Configure")
152 env.AddMethod(__download, "Download")
153 env.AddMethod(__install_head_file, "InstallHeadFile")
154 env.AddMethod(__install_lib, "InstallLib")
156 if env.get('SECURED') == '1' or 'SERVER' in rd_mode:
157 if target_os not in ['linux', 'tizen']:
158 SConscript('#extlibs/sqlite3/SConscript')