// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "chrome/browser/web_applications/web_app.h"
#if defined(OS_WIN)
#include <shlobj.h>
#endif // defined(OS_WIN)
#include "base/command_line.h"
#include "base/file_util.h"
#include "base/i18n/file_util_icu.h"
#include "base/md5.h"
#include "base/path_service.h"
#include "base/string_util.h"
#include "base/threading/thread.h"
#include "base/utf_string_conversions.h"
#include "base/win/windows_version.h"
#include "chrome/browser/download/download_util.h"
#include "chrome/common/chrome_constants.h"
#include "chrome/common/chrome_paths.h"
#include "chrome/common/url_constants.h"
#include "content/browser/browser_thread.h"
#if defined(OS_LINUX)
#include "base/environment.h"
#endif // defined(OS_LINUX)
#if defined(OS_WIN)
#include "ui/gfx/icon_util.h"
#endif // defined(OS_WIN)
namespace {
#if defined(OS_WIN)
const FilePath::CharType kIconChecksumFileExt[] = FILE_PATH_LITERAL(".ico.md5");
// Returns true if |ch| is in visible ASCII range and not one of
// "/ \ : * ? " < > | ; ,".
bool IsValidFilePathChar(char16 c) {
if (c < 32)
return false;
switch (c) {
case '/':
case '\\':
case ':':
case '*':
case '?':
case '"':
case '<':
case '>':
case '|':
case ';':
case ',':
return false;
};
return true;
}
#endif // defined(OS_WIN)
// Returns relative directory of given web app url.
FilePath GetWebAppDir(const ShellIntegration::ShortcutInfo& info) {
if (!info.extension_id.empty()) {
std::string app_name =
web_app::GenerateApplicationNameFromExtensionId(info.extension_id);
#if defined(OS_WIN)
return FilePath(UTF8ToWide(app_name));
#elif defined(OS_POSIX)
return FilePath(app_name);
#endif
} else {
FilePath::StringType host;
FilePath::StringType scheme_port;
#if defined(OS_WIN)
host = UTF8ToWide(info.url.host());
scheme_port = (info.url.has_scheme() ? UTF8ToWide(info.url.scheme())
: L"http") + FILE_PATH_LITERAL("_") +
(info.url.has_port() ? UTF8ToWide(info.url.port()) : L"80");
#elif defined(OS_POSIX)
host = info.url.host();
scheme_port = info.url.scheme() + FILE_PATH_LITERAL("_") + info.url.port();
#endif
return FilePath(host).Append(scheme_port);
}
}
#if defined(TOOLKIT_VIEWS)
// Predicator for sorting images from largest to smallest.
bool IconPrecedes(const WebApplicationInfo::IconInfo& left,
const WebApplicationInfo::IconInfo& right) {
return left.width < right.width;
}
#endif
#if defined(OS_WIN)
// Calculates image checksum using MD5.
void GetImageCheckSum(const SkBitmap& image, MD5Digest* digest) {
DCHECK(digest);
SkAutoLockPixels image_lock(image);
MD5Sum(image.getPixels(), image.getSize(), digest);
}
// Saves |image| as an |icon_file| with the checksum.
bool SaveIconWithCheckSum(const FilePath& icon_file, const SkBitmap& image) {
if (!IconUtil::CreateIconFileFromSkBitmap(image, icon_file))
return false;
MD5Digest digest;
GetImageCheckSum(image, &digest);
FilePath cheksum_file(icon_file.ReplaceExtension(kIconChecksumFileExt));
return file_util::WriteFile(cheksum_file,
reinterpret_cast<const char*>(&digest),
sizeof(digest)) == sizeof(digest);
}
// Returns true if |icon_file| is missing or different from |image|.
bool ShouldUpdateIcon(const FilePath& icon_file, const SkBitmap& image) {
FilePath checksum_file(icon_file.ReplaceExtension(kIconChecksumFileExt));
// Returns true if icon_file or checksum file is missing.
if (!file_util::PathExists(icon_file) ||
!file_util::PathExists(checksum_file))
return true;
MD5Digest persisted_image_checksum;
if (sizeof(persisted_image_checksum) != file_util::ReadFile(checksum_file,
reinterpret_cast<char*>(&persisted_image_checksum),
sizeof(persisted_image_checksum)))
return true;
MD5Digest downloaded_image_checksum;
GetImageCheckSum(image, &downloaded_image_checksum);
// Update icon if checksums are not equal.
return memcmp(&persisted_image_checksum, &downloaded_image_checksum,
sizeof(MD5Digest)) != 0;
}
#endif // defined(OS_WIN)
// Represents a task that creates web application shortcut. This runs on
// file thread and schedules the callback (if any) on the calling thread
// when finished (either success or failure).
class CreateShortcutTask : public Task {
public:
CreateShortcutTask(const FilePath& profile_path,
const ShellIntegration::ShortcutInfo& shortcut_info,
web_app::CreateShortcutCallback* callback);
private:
class CreateShortcutCallbackTask : public Task {
public:
CreateShortcutCallbackTask(web_app::CreateShortcutCallback* callback,
bool success)
: callback_(callback),
success_(success) {
}
// Overridden from Task:
virtual void Run() {
callback_->Run(success_);
}
private:
web_app::CreateShortcutCallback* callback_;
bool success_;
};
// Overridden from Task:
virtual void Run();
// Returns true if shortcut is created successfully.
bool CreateShortcut();
// Path to store persisted data for web app.
FilePath web_app_path_;
// Out copy of profile path.
FilePath profile_path_;
// Our copy of short cut data.
ShellIntegration::ShortcutInfo shortcut_info_;
// Callback when task is finished.
web_app::CreateShortcutCallback* callback_;
MessageLoop* message_loop_;
DISALLOW_COPY_AND_ASSIGN(CreateShortcutTask);
};
CreateShortcutTask::CreateShortcutTask(
const FilePath& profile_path,
const ShellIntegration::ShortcutInfo& shortcut_info,
web_app::CreateShortcutCallback* callback)
: web_app_path_(web_app::internals::GetWebAppDataDirectory(
web_app::GetDataDir(profile_path),
shortcut_info)),
profile_path_(profile_path),
shortcut_info_(shortcut_info),
callback_(callback),
message_loop_(MessageLoop::current()) {
DCHECK(message_loop_ != NULL);
}
void CreateShortcutTask::Run() {
bool success = CreateShortcut();
if (callback_ != NULL)
message_loop_->PostTask(FROM_HERE,
new CreateShortcutCallbackTask(callback_, success));
}
bool CreateShortcutTask::CreateShortcut() {
DCHECK(BrowserThread::CurrentlyOn(BrowserThread::FILE));
#if defined(OS_LINUX)
scoped_ptr<base::Environment> env(base::Environment::Create());
std::string shortcut_template;
if (!ShellIntegration::GetDesktopShortcutTemplate(env.get(),
&shortcut_template)) {
return false;
}
ShellIntegration::CreateDesktopShortcut(shortcut_info_, shortcut_template);
return true; // assuming always success.
#elif defined(OS_WIN)
// Shortcut paths under which to create shortcuts.
std::vector<FilePath> shortcut_paths;
// Locations to add to shortcut_paths.
struct {
const bool& use_this_location;
int location_id;
const wchar_t* sub_dir;
} locations[] = {
{
shortcut_info_.create_on_desktop,
chrome::DIR_USER_DESKTOP,
NULL
}, {
shortcut_info_.create_in_applications_menu,
base::DIR_START_MENU,
NULL
}, {
shortcut_info_.create_in_quick_launch_bar,
// For Win7, create_in_quick_launch_bar means pinning to taskbar. Use
// base::PATH_START as a flag for this case.
(base::win::GetVersion() >= base::win::VERSION_WIN7) ?
base::PATH_START : base::DIR_APP_DATA,
(base::win::GetVersion() >= base::win::VERSION_WIN7) ?
NULL : L"Microsoft\\Internet Explorer\\Quick Launch"
}
};
// Populate shortcut_paths.
for (int i = 0; i < arraysize(locations); ++i) {
if (locations[i].use_this_location) {
FilePath path;
// Skip the Win7 case.
if (locations[i].location_id == base::PATH_START)
continue;
if (!PathService::Get(locations[i].location_id, &path)) {
NOTREACHED();
return false;
}
if (locations[i].sub_dir != NULL)
path = path.Append(locations[i].sub_dir);
shortcut_paths.push_back(path);
}
}
bool pin_to_taskbar =
shortcut_info_.create_in_quick_launch_bar &&
(base::win::GetVersion() >= base::win::VERSION_WIN7);
// For Win7's pinning support, any shortcut could be used. So we only create
// the shortcut file when there is no shortcut file will be created. That is,
// user only selects "Pin to taskbar".
if (pin_to_taskbar && shortcut_paths.empty()) {
// Creates the shortcut in web_app_path_ in this case.
shortcut_paths.push_back(web_app_path_);
}
if (shortcut_paths.empty()) {
NOTREACHED();
return false;
}
// Ensure web_app_path_ exists.
if (!file_util::PathExists(web_app_path_) &&
!file_util::CreateDirectory(web_app_path_)) {
NOTREACHED();
return false;
}
// Generates file name to use with persisted ico and shortcut file.
FilePath file_name =
web_app::internals::GetSanitizedFileName(shortcut_info_.title);
// Creates an ico file to use with shortcut.
FilePath icon_file = web_app_path_.Append(file_name).ReplaceExtension(
FILE_PATH_LITERAL(".ico"));
if (!web_app::internals::CheckAndSaveIcon(icon_file,
shortcut_info_.favicon)) {
NOTREACHED();
return false;
}
FilePath chrome_exe;
if (!PathService::Get(base::FILE_EXE, &chrome_exe)) {
NOTREACHED();
return false;
}
// Working directory.
FilePath chrome_folder = chrome_exe.DirName();
CommandLine cmd_line =
ShellIntegration::CommandLineArgsForLauncher(shortcut_info_.url,
shortcut_info_.extension_id);
// TODO(evan): we rely on the fact that command_line_string() is
// properly quoted for a Windows command line. The method on
// CommandLine should probably be renamed to better reflect that
// fact.
std::wstring wide_switches(cmd_line.command_line_string());
// Sanitize description
if (shortcut_info_.description.length() >= MAX_PATH)
shortcut_info_.description.resize(MAX_PATH - 1);
// Generates app id from web app url and profile path.
std::string app_name =
web_app::GenerateApplicationNameFromInfo(shortcut_info_);
std::wstring app_id = ShellIntegration::GetAppId(
UTF8ToWide(app_name), profile_path_);
FilePath shortcut_to_pin;
bool success = true;
for (size_t i = 0; i < shortcut_paths.size(); ++i) {
FilePath shortcut_file = shortcut_paths[i].Append(file_name).
ReplaceExtension(FILE_PATH_LITERAL(".lnk"));
int unique_number = download_util::GetUniquePathNumber(shortcut_file);
if (unique_number == -1) {
success = false;
continue;
} else if (unique_number > 0) {
download_util::AppendNumberToPath(&shortcut_file, unique_number);
}
success &= file_util::CreateShortcutLink(chrome_exe.value().c_str(),
shortcut_file.value().c_str(),
chrome_folder.value().c_str(),
wide_switches.c_str(),
shortcut_info_.description.c_str(),
icon_file.value().c_str(),
0,
app_id.c_str());
// Any shortcut would work for the pinning. We use the first one.
if (success && pin_to_taskbar && shortcut_to_pin.empty())
shortcut_to_pin = shortcut_file;
}
if (success && pin_to_taskbar) {
if (!shortcut_to_pin.empty()) {
success &= file_util::TaskbarPinShortcutLink(
shortcut_to_pin.value().c_str());
} else {
NOTREACHED();
success = false;
}
}
return success;
#else
NOTIMPLEMENTED();
return false;
#endif
}
} // namespace
namespace web_app {
// The following string is used to build the directory name for
// shortcuts to chrome applications (the kind which are installed
// from a CRX). Application shortcuts to URLs use the {host}_{path}
// for the name of this directory. Hosts can't include an underscore.
// By starting this string with an underscore, we ensure that there
// are no naming conflicts.
static const char* kCrxAppPrefix = "_crx_";
namespace internals {
#if defined(OS_WIN)
// Returns sanitized name that could be used as a file name
FilePath GetSanitizedFileName(const string16& name) {
string16 file_name;
for (size_t i = 0; i < name.length(); ++i) {
char16 c = name[i];
if (!IsValidFilePathChar(c))
c = '_';
file_name += c;
}
return FilePath(file_name);
}
// Saves |image| to |icon_file| if the file is outdated and refresh shell's
// icon cache to ensure correct icon is displayed. Returns true if icon_file
// is up to date or successfully updated.
bool CheckAndSaveIcon(const FilePath& icon_file, const SkBitmap& image) {
if (ShouldUpdateIcon(icon_file, image)) {
if (SaveIconWithCheckSum(icon_file, image)) {
// Refresh shell's icon cache. This call is quite disruptive as user would
// see explorer rebuilding the icon cache. It would be great that we find
// a better way to achieve this.
SHChangeNotify(SHCNE_ASSOCCHANGED, SHCNF_IDLIST | SHCNF_FLUSHNOWAIT,
NULL, NULL);
} else {
return false;
}
}
return true;
}
#endif // OS_WIN
// Returns data directory for given web app url
FilePath GetWebAppDataDirectory(const FilePath& root_dir,
const ShellIntegration::ShortcutInfo& info) {
return root_dir.Append(GetWebAppDir(info));
}
} // namespace internals
std::string GenerateApplicationNameFromInfo(
const ShellIntegration::ShortcutInfo& shortcut_info) {
if (!shortcut_info.extension_id.empty()) {
return web_app::GenerateApplicationNameFromExtensionId(
shortcut_info.extension_id);
} else {
return web_app::GenerateApplicationNameFromURL(
shortcut_info.url);
}
}
std::string GenerateApplicationNameFromURL(const GURL& url) {
std::string t;
t.append(url.host());
t.append("_");
t.append(url.path());
return t;
}
std::string GenerateApplicationNameFromExtensionId(const std::string& id) {
std::string t(web_app::kCrxAppPrefix);
t.append(id);
return t;
}
void CreateShortcut(
const FilePath& data_dir,
const ShellIntegration::ShortcutInfo& shortcut_info,
CreateShortcutCallback* callback) {
BrowserThread::PostTask(BrowserThread::FILE, FROM_HERE,
new CreateShortcutTask(data_dir, shortcut_info, callback));
}
bool IsValidUrl(const GURL& url) {
static const char* const kValidUrlSchemes[] = {
chrome::kFileScheme,
chrome::kFtpScheme,
chrome::kHttpScheme,
chrome::kHttpsScheme,
chrome::kExtensionScheme,
};
for (size_t i = 0; i < arraysize(kValidUrlSchemes); ++i) {
if (url.SchemeIs(kValidUrlSchemes[i]))
return true;
}
return false;
}
FilePath GetDataDir(const FilePath& profile_path) {
return profile_path.Append(chrome::kWebAppDirname);
}
#if defined(TOOLKIT_VIEWS)
void GetIconsInfo(const WebApplicationInfo& app_info,
IconInfoList* icons) {
DCHECK(icons);
icons->clear();
for (size_t i = 0; i < app_info.icons.size(); ++i) {
// We only take square shaped icons (i.e. width == height).
if (app_info.icons[i].width == app_info.icons[i].height) {
icons->push_back(app_info.icons[i]);
}
}
std::sort(icons->begin(), icons->end(), &IconPrecedes);
}
#endif
#if defined(TOOLKIT_USES_GTK)
std::string GetWMClassFromAppName(std::string app_name) {
file_util::ReplaceIllegalCharactersInPath(&app_name, '_');
TrimString(app_name, "_", &app_name);
return app_name;
}
#endif
} // namespace web_app