1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
// Copyright 2019 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_WEB_APPLICATIONS_OS_INTEGRATION_WEB_APP_FILE_HANDLER_REGISTRATION_H_
#define CHROME_BROWSER_WEB_APPLICATIONS_OS_INTEGRATION_WEB_APP_FILE_HANDLER_REGISTRATION_H_
#include <string>
#include "base/files/file_path.h"
#include "base/functional/callback.h"
#include "build/build_config.h"
#include "chrome/browser/web_applications/web_app_constants.h"
#include "components/services/app_service/public/cpp/file_handler.h"
#include "components/webapps/common/web_app_id.h"
namespace web_app {
// True if file handlers are managed externally by the operating system, and
// Chrome supports file handling on this operating system.
// In practice, this is false on Chrome OS (as Chrome OS uses Chrome's installed
// apps to find file handlers), and on operating systems where Chrome doesn't
// know how to register file handlers.
bool ShouldRegisterFileHandlersWithOs();
// Returns true if file type association icons are supported by the OS.
bool FileHandlingIconsSupportedByOs();
// Do OS-specific registration to handle opening files with the specified
// |file_extensions| and |mime_types| with the PWA with the specified |app_id|.
// This may also involve creating a shim app to launch Chrome from.
// Note: Some operating systems (such as Chrome OS) may not need to do any work
// here.
void RegisterFileHandlersWithOs(const webapps::AppId& app_id,
const std::string& app_name,
const base::FilePath& profile_path,
const apps::FileHandlers& file_handlers,
ResultCallback callback);
// Undo the file extensions registration for the PWA with specified |app_id|.
// If a shim app was required, also removes the shim app.
void UnregisterFileHandlersWithOs(const webapps::AppId& app_id,
const base::FilePath& profile_path,
ResultCallback callback);
#if BUILDFLAG(IS_LINUX)
// Exposed for testing purposes. Register the set of
// MIME-type-to-file-extensions mappings corresponding to |file_handlers|. File
// I/O and callouts to the Linux shell are performed asynchronously.
//
// It is worth nothing that file handlers in the current implementation work
// with respect to mime types, and will disregard file extensions on Linux.
// Example: If the mime-type supported is text/plain and the file types
// specified in the manifest are only .csv and .md, .txt files are also
// registered as file handlers, and the file is launched.
// TODO(crbug.com/40263546): Implement stricter handling w.r.t file extensions.
void InstallMimeInfoOnLinux(const webapps::AppId& app_id,
const base::FilePath& profile_path,
const apps::FileHandlers& file_handlers,
ResultCallback done_callback);
using UpdateMimeInfoDatabaseOnLinuxCallback =
base::RepeatingCallback<bool(base::FilePath file_path,
std::string xdg_command,
std::string file_contents)>;
// Override the |callback| used to handle updating the Linux MIME-info database
// (the default is to use xdg-mime).
void SetUpdateMimeInfoDatabaseOnLinuxCallbackForTesting(
UpdateMimeInfoDatabaseOnLinuxCallback callback);
#endif
} // namespace web_app
#endif // CHROME_BROWSER_WEB_APPLICATIONS_OS_INTEGRATION_WEB_APP_FILE_HANDLER_REGISTRATION_H_
|
