Merge remote-tracking branch 'origin/develop-9.0' into merge-develop-9.0-18.06.2019

Author: livecodepanos

README.md

@@ -0,0 +1,39 @@
+# LiveCode Thirdparty Libraries
+
+The procedure for updating `thirdparty` on `develop-9.0` and `develop` branches is
+slightly different due to `thirdparty` prebuilts on develop. 
+
+## Update procedure for develop-9.0
+
+1. Push up a PR to this repo
+2. If there is a related patch to another repos then push up a PR for those
+3. Create a test branch on `livecode` with updated submodule ptrs. Ensure the
+branch is pushed upstream rather than to your clone.
+4. If it was a CEF update then push up a branch to `livecode-private` again with 
+updated submodule and kick off prebuilts on vulcan.
+5. Create a PR with the title beginning with `[[ NO MERGE ]]` and review it ok
+to confirm it passes on travis and vulcan
+6. Close PR from 5 and link to it in the other related PRs
+7. Once all related PRs are reviewed merge `thirdparty`, update submodules in
+`livecode` and merge any related PRs
+
+## Update procedure for develop
+
+The same procedure applies to merge-ups from `develop-9.0` because the 
+`thirdparty` prebuilts must be rebuilt for the current head of the `develop`
+branch.
+
+1. Push up a PR to this repo
+2. If there is a related patch to another repos then push up a PR for those
+3. Review and merge the PR for `thirdparty` but *do not* update submodule ptrs
+in `livecode` yet.
+4. Create a test branch on `livecode` with updated submodule ptrs. Ensure the
+branch is pushed upstream rather than to your clone.
+5. Push up a branch to `livecode-private` again with updated submodule and kick
+off prebuilts on vulcan.
+6. Once prebuilts are built for the `develop` head of `thirdparty` create a PR
+using the `livecode` branch with the title beginning with `[[ NO MERGE ]]` and
+review it ok to confirm it passes on travis and vulcan
+7. Close PR from 6 and link to it in the other related PRs
+8. Once all related PRs are reviewed, update submodules in `livecode` and merge
+any related PRs

libcef/Makefile

@@ -0,0 +1,24 @@
+# Steps for updating CEF
+
+- Go to http://opensource.spotify.com/cefbuilds/index.html
+- Download the latest standard distribution for Windows and Linux and extract
+- Delete `thirdparty/libcef/include` and `thirdparty/libcef/libcef_dll`
+- Copy `include` and `libcef_dll` from the CEF windows build to
+`thirdparty/libcef`
+- Execute `python gen_libcef_paths.py libcef_dll > libcef.gypi`
+- Execute `python gen_libcef_stubs.py include > libcef.stubs`
+- Stderr will list unknown parameter or return types so edit `gen_libcef_stubs.py`
+to add them and run again
+- Copy `include` from the CEF linux build to `thirdparty/libcef` to merge  in
+the extra headers required for linux. Note this is done after the stubs are
+generated so we don't include stubs for anything linux specific which seems to
+be `cef_get_xdisplay` at the moment.
+- CD to `thirdparty/libcef`
+- Copy binaries and resources from the CEF build to the prebuilt folders checking
+for any new file names to update in the gyp files and prebuilt builder. Note copy
+the binaries from the Release folder even to the debug prebuilt folders.
+- Reconfigure and build
+- Fix any API changes and make sure things work
+- Update `prebuilt/versions/cef` and `prebuilt/versions/cef_buildrevision`
+- Push up a patch to livecode and thirdparty
+- Kick off prebuilts

libcef/Makefile.libcef

@@ -0,0 +1,40 @@
+#!/usr/bin/env python
+
+import os
+import sys
+import posixpath
+
+def log(pMsg):
+	sys.stderr.write(pMsg + "\n")
+	sys.stderr.flush()
+
+def gen_paths_file(pPaths):
+	tFileList = []
+	
+	for tPath in pPaths:
+		for tRoot, tFolders, tFiles in os.walk(tPath):
+			if os.path.basename(tRoot) != "test":	
+				tFileNames = filter(lambda(s) : s.endswith(".h") or s.endswith(".cc"), tFiles)
+				
+				tRoot = tRoot.replace(os.path.sep, "/")
+
+				for tFile in tFileNames:
+					tFileList.append("\t\t\t'" +  posixpath.join(tRoot, tFile) + "',")
+
+	tFileList.sort()
+	
+	print "{\n"
+	print "\t'variables': {\n"
+	print "\t\t'libcef_dll_sources': [\n"
+	
+	print "\n".join(tFileList)
+	
+	print "\t\t]\n\t}\n}\n"
+	
+
+#get include folder from the command line
+tPaths = ["."]
+if len(sys.argv) > 1:
+	tPaths = sys.argv[1:]
+
+gen_paths_file(tPaths)