/* * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package com.oracle.tools.packager.mac; import com.oracle.tools.packager.*; import com.oracle.tools.packager.IOUtils; import java.io.*; import java.text.MessageFormat; import java.util.*; import static com.oracle.tools.packager.StandardBundlerParam.*; public class MacDmgBundler extends MacBaseInstallerBundler { private static final ResourceBundle I18N = ResourceBundle.getBundle(MacDmgBundler.class.getName()); static final String DEFAULT_BACKGROUND_IMAGE="background_dmg.png"; static final String DEFAULT_DMG_SETUP_SCRIPT="DMGsetup.scpt"; static final String TEMPLATE_BUNDLE_ICON = "GenericApp.icns"; //existing SQE tests look for "license" string in the filenames // when they look for unauthorized license files in the build artifacts // Use different name to make them happy static final String DEFAULT_LICENSE_PLIST="lic_template.plist"; public static final BundlerParamInfo SIMPLE_DMG = new StandardBundlerParam<>( I18N.getString("param.simple-dmg.name"), I18N.getString("param.simple-dmg.description"), "mac.dmg.simple", Boolean.class, params -> Boolean.FALSE, (s, p) -> Boolean.parseBoolean(s)); public static final BundlerParamInfo INSTALLER_SUFFIX = new StandardBundlerParam<> ( I18N.getString("param.installer-suffix.name"), I18N.getString("param.installer-suffix.description"), "mac.dmg.installerName.suffix", String.class, params -> "", (s, p) -> s); public MacDmgBundler() { super(); baseResourceLoader = MacResources.class; } //@Override public File bundle(Map params, File outdir) { Log.info(MessageFormat.format(I18N.getString("message.building-dmg"), APP_NAME.fetchFrom(params))); if (!outdir.isDirectory() && !outdir.mkdirs()) { throw new RuntimeException(MessageFormat.format(I18N.getString("error.cannot-create-output-dir"), outdir.getAbsolutePath())); } if (!outdir.canWrite()) { throw new RuntimeException(MessageFormat.format(I18N.getString("error.cannot-write-to-output-dir"), outdir.getAbsolutePath())); } File appImageDir = APP_IMAGE_BUILD_ROOT.fetchFrom(params); try { appImageDir.mkdirs(); if (prepareAppBundle(params) != null && prepareConfigFiles(params)) { File configScript = getConfig_Script(params); if (configScript.exists()) { Log.info(MessageFormat.format(I18N.getString("message.running-script"), configScript.getAbsolutePath())); IOUtils.run("bash", configScript, VERBOSE.fetchFrom(params)); } return buildDMG(params, outdir); } return null; } catch (IOException ex) { Log.verbose(ex); return null; } finally { try { if (appImageDir != null && !Log.isDebug()) { IOUtils.deleteRecursive(appImageDir); } else if (appImageDir != null) { Log.info(MessageFormat.format(I18N.getString("message.intermediate-image-location"), appImageDir.getAbsolutePath())); } if (!VERBOSE.fetchFrom(params)) { //cleanup cleanupConfigFiles(params); } else { Log.info(MessageFormat.format(I18N.getString("message.config-save-location"), CONFIG_ROOT.fetchFrom(params).getAbsolutePath())); } } catch (FileNotFoundException ex) { Log.debug(ex); //noinspection ReturnInsideFinallyBlock return null; } } } //remove protected void cleanupConfigFiles(Map params) { if (getConfig_VolumeBackground(params) != null) { getConfig_VolumeBackground(params).delete(); } if (getConfig_VolumeIcon(params) != null) { getConfig_VolumeIcon(params).delete(); } if (getConfig_VolumeScript(params) != null) { getConfig_VolumeScript(params).delete(); } if (getConfig_Script(params) != null) { getConfig_Script(params).delete(); } if (getConfig_LicenseFile(params) != null) { getConfig_LicenseFile(params).delete(); } APP_BUNDLER.fetchFrom(params).cleanupConfigFiles(params); } private static final String hdiutil = "/usr/bin/hdiutil"; private void prepareDMGSetupScript(String volumeName, Map p) throws IOException { File dmgSetup = getConfig_VolumeScript(p); Log.verbose(MessageFormat.format(I18N.getString("message.preparing-dmg-setup"), dmgSetup.getAbsolutePath())); //prepare config for exe Map data = new HashMap<>(); data.put("DEPLOY_ACTUAL_VOLUME_NAME", volumeName); data.put("DEPLOY_APPLICATION_NAME", APP_NAME.fetchFrom(p)); //treat default null as "system wide install" boolean systemWide = SYSTEM_WIDE.fetchFrom(p) == null || SYSTEM_WIDE.fetchFrom(p); if (systemWide) { data.put("DEPLOY_INSTALL_LOCATION", "POSIX file \"/Applications\""); data.put("DEPLOY_INSTALL_NAME", "Applications"); } else { data.put("DEPLOY_INSTALL_LOCATION", "(path to desktop folder)"); data.put("DEPLOY_INSTALL_NAME", "Desktop"); } Writer w = new BufferedWriter(new FileWriter(dmgSetup)); w.write(preprocessTextResource( MacAppBundler.MAC_BUNDLER_PREFIX + dmgSetup.getName(), I18N.getString("resource.dmg-setup-script"), DEFAULT_DMG_SETUP_SCRIPT, data, VERBOSE.fetchFrom(p), DROP_IN_RESOURCES_ROOT.fetchFrom(p))); w.close(); } private File getConfig_VolumeScript(Map params) { return new File(CONFIG_ROOT.fetchFrom(params), APP_NAME.fetchFrom(params) + "-dmg-setup.scpt"); } private File getConfig_VolumeBackground(Map params) { return new File(CONFIG_ROOT.fetchFrom(params), APP_NAME.fetchFrom(params) + "-background.png"); } private File getConfig_VolumeIcon(Map params) { return new File(CONFIG_ROOT.fetchFrom(params), APP_NAME.fetchFrom(params) + "-volume.icns"); } private File getConfig_LicenseFile(Map params) { return new File(CONFIG_ROOT.fetchFrom(params), APP_NAME.fetchFrom(params) + "-license.plist"); } private void prepareLicense(Map params) { try { File licFile = null; List licFiles = LICENSE_FILE.fetchFrom(params); if (licFiles.isEmpty()) { return; } String licFileStr = licFiles.get(0); for (RelativeFileSet rfs : APP_RESOURCES_LIST.fetchFrom(params)) { if (rfs.contains(licFileStr)) { licFile = new File(rfs.getBaseDirectory(), licFileStr); break; } } if (licFile == null) { // this is NPE protection, validate should have caught it's absence // so we don't complain or throw an error return; } byte[] licenseContentOriginal = IOUtils.readFully(licFile); String licenseInBase64 = Base64.getEncoder().encodeToString(licenseContentOriginal); Map data = new HashMap<>(); data.put("APPLICATION_LICENSE_TEXT", licenseInBase64); Writer w = new BufferedWriter(new FileWriter(getConfig_LicenseFile(params))); w.write(preprocessTextResource( MacAppBundler.MAC_BUNDLER_PREFIX + getConfig_LicenseFile(params).getName(), I18N.getString("resource.license-setup"), DEFAULT_LICENSE_PLIST, data, VERBOSE.fetchFrom(params), DROP_IN_RESOURCES_ROOT.fetchFrom(params))); w.close(); } catch (IOException ex) { Log.verbose(ex); } } private boolean prepareConfigFiles(Map params) throws IOException { File bgTarget = getConfig_VolumeBackground(params); fetchResource(MacAppBundler.MAC_BUNDLER_PREFIX + bgTarget.getName(), I18N.getString("resource.dmg-background"), DEFAULT_BACKGROUND_IMAGE, bgTarget, VERBOSE.fetchFrom(params), DROP_IN_RESOURCES_ROOT.fetchFrom(params)); File iconTarget = getConfig_VolumeIcon(params); if (MacAppBundler.ICON_ICNS.fetchFrom(params) == null || !MacAppBundler.ICON_ICNS.fetchFrom(params).exists()) { fetchResource(MacAppBundler.MAC_BUNDLER_PREFIX + iconTarget.getName(), I18N.getString("resource.volume-icon"), TEMPLATE_BUNDLE_ICON, iconTarget, VERBOSE.fetchFrom(params), DROP_IN_RESOURCES_ROOT.fetchFrom(params)); } else { fetchResource(MacAppBundler.MAC_BUNDLER_PREFIX + iconTarget.getName(), I18N.getString("resource.volume-icon"), MacAppBundler.ICON_ICNS.fetchFrom(params), iconTarget, VERBOSE.fetchFrom(params), DROP_IN_RESOURCES_ROOT.fetchFrom(params)); } fetchResource(MacAppBundler.MAC_BUNDLER_PREFIX + getConfig_Script(params).getName(), I18N.getString("resource.post-install-script"), (String) null, getConfig_Script(params), VERBOSE.fetchFrom(params), DROP_IN_RESOURCES_ROOT.fetchFrom(params)); prepareLicense(params); //In theory we need to extract name from results of attach command //However, this will be a problem for customization as name will //possibly change every time and developer will not be able to fix it //As we are using tmp dir chance we get "different" namr are low => //Use fixed name we used for bundle prepareDMGSetupScript(APP_NAME.fetchFrom(params), params); return true; } //name of post-image script private File getConfig_Script(Map params) { return new File(CONFIG_ROOT.fetchFrom(params), APP_NAME.fetchFrom(params) + "-post-image.sh"); } //Location of SetFile utility may be different depending on MacOS version // We look for several known places and if none of them work will // try ot find it private String findSetFileUtility() { String typicalPaths[] = {"/Developer/Tools/SetFile", "/usr/bin/SetFile", "/Developer/usr/bin/SetFile"}; for (String path: typicalPaths) { File f = new File(path); if (f.exists() && f.canExecute()) { return path; } } //generic find attempt try { ProcessBuilder pb = new ProcessBuilder("xcrun", "-find", "SetFile"); Process p = pb.start(); InputStreamReader isr = new InputStreamReader(p.getInputStream()); BufferedReader br = new BufferedReader(isr); String lineRead = br.readLine(); if (lineRead != null) { File f = new File(lineRead); if (f.exists() && f.canExecute()) { return f.getAbsolutePath(); } } } catch (IOException ignored) {} return null; } private File buildDMG( Map p, File outdir) throws IOException { File imagesRoot = IMAGES_ROOT.fetchFrom(p); if (!imagesRoot.exists()) imagesRoot.mkdirs(); File protoDMG = new File(imagesRoot, APP_NAME.fetchFrom(p) +"-tmp.dmg"); File finalDMG = new File(outdir, INSTALLER_NAME.fetchFrom(p) + INSTALLER_SUFFIX.fetchFrom(p) + ".dmg"); File srcFolder = APP_IMAGE_BUILD_ROOT.fetchFrom(p); //new File(imageDir, p.name+".app"); File predefinedImage = getPredefinedImage(p); if (predefinedImage != null) { srcFolder = predefinedImage; } Log.verbose(MessageFormat.format(I18N.getString("message.creating-dmg-file"), finalDMG.getAbsolutePath())); protoDMG.delete(); if (finalDMG.exists() && !finalDMG.delete()) { throw new IOException(MessageFormat.format(I18N.getString("message.dmg-cannot-be-overwritten"), finalDMG.getAbsolutePath())); } protoDMG.getParentFile().mkdirs(); finalDMG.getParentFile().mkdirs(); String hdiUtilVerbosityFlag = Log.isDebug() ? "-verbose" : "-quiet"; //create temp image ProcessBuilder pb = new ProcessBuilder( hdiutil, "create", hdiUtilVerbosityFlag, "-srcfolder", srcFolder.getAbsolutePath(), "-volname", APP_NAME.fetchFrom(p), "-ov", protoDMG.getAbsolutePath(), "-format", "UDRW"); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); //mount temp image pb = new ProcessBuilder( hdiutil, "attach", protoDMG.getAbsolutePath(), hdiUtilVerbosityFlag, "-mountroot", imagesRoot.getAbsolutePath()); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); File mountedRoot = new File(imagesRoot.getAbsolutePath(), APP_NAME.fetchFrom(p)); //volume icon File volumeIconFile = new File(mountedRoot, ".VolumeIcon.icns"); IOUtils.copyFile(getConfig_VolumeIcon(p), volumeIconFile); if (!SIMPLE_DMG.fetchFrom(p)) { //background image File bgdir = new File(mountedRoot, ".background"); bgdir.mkdirs(); IOUtils.copyFile(getConfig_VolumeBackground(p), new File(bgdir, "background.png")); pb = new ProcessBuilder("osascript", getConfig_VolumeScript(p).getAbsolutePath()); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); } //Indicate that we want a custom icon //NB: attributes of the root directory are ignored when creating the volume // Therefore we have to do this after we mount image String setFileUtility = findSetFileUtility(); if (setFileUtility != null) { //can not find utility => keep going without icon volumeIconFile.setWritable(true); // The "creator" attribute on a file is a legacy attribute // but it seems Finder excepts these bytes to be "icnC" for the volume icon // (http://endrift.com/blog/2010/06/14/dmg-files-volume-icons-cli/) pb = new ProcessBuilder( setFileUtility, "-c", "icnC", volumeIconFile.getAbsolutePath()); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); volumeIconFile.setReadOnly(); pb = new ProcessBuilder( setFileUtility, "-a", "C", mountedRoot.getAbsolutePath()); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); } else { Log.verbose("Skip enabling custom icon as SetFile utility is not found"); } // Detach the temporary image pb = new ProcessBuilder( hdiutil, "detach", hdiUtilVerbosityFlag, mountedRoot.getAbsolutePath()); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); // Compress it to a new image pb = new ProcessBuilder( hdiutil, "convert", protoDMG.getAbsolutePath(), hdiUtilVerbosityFlag, "-format", "UDZO", "-o", finalDMG.getAbsolutePath()); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); //add license if needed if (getConfig_LicenseFile(p).exists()) { //hdiutil unflatten your_image_file.dmg pb = new ProcessBuilder( hdiutil, "unflatten", finalDMG.getAbsolutePath() ); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); //add license pb = new ProcessBuilder( hdiutil, "udifrez", finalDMG.getAbsolutePath(), "-xml", getConfig_LicenseFile(p).getAbsolutePath() ); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); //hdiutil flatten your_image_file.dmg pb = new ProcessBuilder( hdiutil, "flatten", finalDMG.getAbsolutePath() ); IOUtils.exec(pb, VERBOSE.fetchFrom(p)); } //Delete the temporary image protoDMG.delete(); Log.info(MessageFormat.format(I18N.getString("message.output-to-location"), APP_NAME.fetchFrom(p), finalDMG.getAbsolutePath())); return finalDMG; } ////////////////////////////////////////////////////////////////////////////////// // Implement Bundler ////////////////////////////////////////////////////////////////////////////////// @Override public String getName() { return I18N.getString("bundler.name"); } @Override public String getDescription() { return I18N.getString("bundler.description"); } @Override public String getID() { return "dmg"; } @Override public Collection> getBundleParameters() { Collection> results = new LinkedHashSet<>(); results.addAll(MacAppBundler.getAppBundleParameters()); results.addAll(getDMGBundleParameters()); return results; } public Collection> getDMGBundleParameters() { Collection> results = new LinkedHashSet<>(); results.addAll(MacAppBundler.getAppBundleParameters()); results.addAll(Arrays.asList( INSTALLER_SUFFIX, LICENSE_FILE, SIMPLE_DMG, SYSTEM_WIDE )); return results; } @Override public boolean validate(Map params) throws UnsupportedPlatformException, ConfigException { try { if (params == null) throw new ConfigException( I18N.getString("error.parameters-null"), I18N.getString("error.parameters-null.advice")); //run basic validation to ensure requirements are met //we are not interested in return code, only possible exception validateAppImageAndBundeler(params); // hdiutil is always available so there's no need to test for availability. if (SERVICE_HINT.fetchFrom(params)) { throw new ConfigException( I18N.getString("error.dmg-does-not-do-daemons"), I18N.getString("error.dmg-does-not-do-daemons.advice")); } // validate license file, if used, exists in the proper place if (params.containsKey(LICENSE_FILE.getID())) { List appResourcesList = APP_RESOURCES_LIST.fetchFrom(params); for (String license : LICENSE_FILE.fetchFrom(params)) { boolean found = false; for (RelativeFileSet appResources : appResourcesList) { found = found || appResources.contains(license); } if (!found) { throw new ConfigException( I18N.getString("error.license-missing"), MessageFormat.format(I18N.getString("error.license-missing.advice"), license)); } } } return true; } catch (RuntimeException re) { if (re.getCause() instanceof ConfigException) { throw (ConfigException) re.getCause(); } else { throw new ConfigException(re); } } } @Override public File execute(Map params, File outputParentDir) { return bundle(params, outputParentDir); } }