Publish Vulpes Preview 15 sources for desktop, Android and Tundra

Share Gaia assets and adapters, keep private profiles and development documents local, and update both public READMEs.

gaia/build/homescreen-manager.js

@@ -0,0 +1,153 @@
+'use strict';
+
+const utils = require('./utils');
+const BASE_ICON_SIZE = 60;
+
+function isAbsoluteURL(url) {
+  return url.indexOf('data:') === 0 ||
+         url.indexOf('app://') === 0 ||
+         url.indexOf('http://') === 0 ||
+         url.indexOf('https://') === 0;
+}
+
+// c.f. the corresponding implementation in the Homescreen app.
+function bestMatchingIcon(config, manifest, origin) {
+  var icons = manifest.icons;
+  if (!icons) {
+    return undefined;
+  }
+
+  var preferredIconSize = Number.MAX_VALUE;
+  var max = 0;
+
+  for (var size in icons) {
+    size = parseInt(size, 10);
+    if (size > max) {
+      max = size;
+    }
+
+    if (size >= config.preferredIconSize && size < preferredIconSize) {
+      preferredIconSize = size;
+    }
+  }
+  // If there is an icon matching the preferred size, we return the result,
+  // if there isn't, we will return the maximum available size.
+  if (preferredIconSize === Number.MAX_VALUE) {
+    preferredIconSize = max;
+  }
+
+  var url = icons[preferredIconSize];
+  if (!url) {
+    return undefined;
+  }
+
+  // If the icon path is not an absolute URL, prepend the app's origin.
+
+  if (!isAbsoluteURL(url)) {
+    url = origin + url;
+  }
+
+  return url;
+}
+
+function getAppMetadata(config, directory, appName, entryPoint) {
+  var origin = null;
+  var manifestURL = null;
+
+  if (!config.webappsMapping[appName]) {
+    utils.log('homescreen-manager', 'Warning: Can not find application ' +
+      appName + ' at ' + directory + '\n');
+    return;
+  }
+
+  var manifest = config.webappsMapping[appName].originalManifest;
+
+  let entryPoints = manifest.entry_points;
+  if (entryPoint && entryPoints && entryPoints[entryPoint]) {
+    manifest = entryPoints[entryPoint];
+  }
+
+  origin = config.webappsMapping[appName].origin;
+  manifestURL = config.webappsMapping[appName].manifestURL;
+
+  let descriptor = {
+    entry_point: entryPoint
+  };
+
+  descriptor.name = manifest.name;
+  descriptor.manifestURL = manifestURL;
+  descriptor.icon = bestMatchingIcon(config, manifest, origin);
+
+  return descriptor;
+}
+
+function customizeHomescreen(config, homescreen) {
+  var content = {
+    grid: homescreen.homescreens.map(
+      function mapHomescreens(applist) {
+        var output = [];
+        for (var i = 0; i < applist.length; i++) {
+          if (applist[i] !== null) {
+            var meta = getAppMetadata(config, applist[i][0],
+                                      applist[i][1], applist[i][2]);
+            meta && output.push(meta);
+          }
+        }
+        return output;
+      }
+    ),
+    preferences: homescreen.preferences || {}
+  };
+
+  return content;
+}
+
+function loadHomescreen(config, homescreen) {
+  homescreen = homescreen || 'verticalhome';
+  var defaultConfig = utils.getFile(config.GAIA_DIR, 'apps', homescreen,
+    'build', 'default-homescreens.json');
+  var customize = utils.getJSON(defaultConfig);
+
+  // Load device specific configuration
+  var deviceConfig = utils.getFile(config.GAIA_DIR, 'build', 'config',
+    config.GAIA_DEVICE_TYPE, 'homescreens.json');
+  if (deviceConfig.exists()) {
+    customize = utils.getJSON(deviceConfig);
+  }
+
+  // Load distribution specific configuration
+  if (config.GAIA_DISTRIBUTION_DIR) {
+    var distributionCustom =
+      JSON.parse(utils.getDistributionFileContent('homescreens',
+        customize, config.GAIA_DISTRIBUTION_DIR));
+    customize = customizeSettings(customize, distributionCustom);
+  }
+
+  return customize;
+}
+
+function customizeSettings(origin, custom) {
+  Object.keys(custom).forEach(function(key) {
+    origin[key] = custom[key];
+  });
+  return origin;
+}
+
+function configure(config) {
+  config.preferredIconSize = BASE_ICON_SIZE *
+                             parseFloat(config.GAIA_DEV_PIXELS_PER_PX);
+
+  var mappingFile = utils.getFile(config.STAGE_DIR, 'webapps_stage.json');
+  if (!mappingFile.exists()) {
+    throw new Error('build_stage/webapps_stage.json not found.');
+  }
+  config.webappsMapping = utils.getJSON(mappingFile);
+
+  config.displayHeight = config.GAIA_DEV_DISPLAY_HEIGHT;
+}
+
+exports.getHomescreen = function(config, homescreen) {
+  configure(config);
+  var rawHomescreen = loadHomescreen(config, homescreen);
+  return customizeHomescreen(config, rawHomescreen);
+};