summaryrefslogtreecommitdiff
path: root/distribution/osx/gtk-bundle/gtk-bundle.README
diff options
context:
space:
mode:
Diffstat (limited to 'distribution/osx/gtk-bundle/gtk-bundle.README')
-rw-r--r--distribution/osx/gtk-bundle/gtk-bundle.README44
1 files changed, 44 insertions, 0 deletions
diff --git a/distribution/osx/gtk-bundle/gtk-bundle.README b/distribution/osx/gtk-bundle/gtk-bundle.README
new file mode 100644
index 0000000..139cec7
--- /dev/null
+++ b/distribution/osx/gtk-bundle/gtk-bundle.README
@@ -0,0 +1,44 @@
+Readme for gtk-bundle directory.
+Created 12-1-2016 by Adam Richards
+
+Date: Dec-2016.
+
+The gtk-bundle technique replaces prior bundle techniques for OSX.
+
+Prerequisites:
+This directory produces files only for use with the gtk-mac-bundler tool (G-M-B).
+That tool is available as a MacPort and should be installed with
+"sudo port install gtk-mac-bundler"
+The bundler also requires a prior Macports install of GTK
+"sudo port install webkit-gtk"
+and that was the GTK level was used to build the xtrkcad binary.
+
+The ccmake process will place a copy of the binary in the /bin build subdirectory
+for use by G-M-B. It also copies over the resource share libraries into a subdirectory.
+
+Process:
+Once ccmake has been run "make" followed by "make install", the G-M-B tool is run
+pointing at the xtrkcad.bundle file.
+"cd /gtk-bundle"
+"gtk-mac-bundler xtrkcad-bundle"
+
+Output:
+G-M-B produces an .app bundle that is a self-contained executable
+from the binary xtrkcad in gtk-bundle/bin. It recursively rewires all the link pointers to be
+self-referential - that is, to point within the bundle.
+
+It uses the xtrkcad.plist to set properties of the app, including the
+icon from the .icns file. It sets the pre-run script to be xtrkcad-launcher.sh
+
+Next Steps:
+Once this xtrkcad.app file has been created, it can be moved to wherever is desirable
+- such as the Application folder. The app does not have dependencies on GTK components
+from MACPorts like the binary does - it is standalone.
+
+To produce an installable image from the .app, the disk utility can be used to create
+a RW image .dmg that the .app can be copied into.
+
+NOTE -
+It is expected that as long as the GTK level used in build can run on the OSX level used
+in build, the app bundle will work without necessarily having to be rebuilt for each OSX
+level. \ No newline at end of file