660509b6b4
There are a number of interesting things going on this patch that I think are worth highlighting here for my reviewers: 1. The single-file archive format is an HTML file that uses an inlined multipart/mixed MIME message within a HTML document comment in order to embed the backup data into the archive. 2. We use the multipart/mixed nsIStreamConverter to extract the JSON and binary data from the MIME block. 3. We use a Archive Worker to do the archive creation, allowing us to do the work of construction off of the main thread. 4. The Archive Worker is only parsing the header and getting the byte offset of the MIME block. Extraction is happening in the parent process. This is mainly for simplicity for now, since the Archive Worker cannot invoke an nsIStreamConverter. Down the line, if we determine that we'd prefer the Archive Worker do the base64 decoding off of the main thread, we may need to use a Message Channel to send the byte sfrom the nsIStreamConverter to it, and add stream-writing support to IOUtils so that the Archive Worker can take care of sending the decoded bytes to disk. 5. The patch doesn't expose the extraction mechanism in any way except through the debug interface right now. That will come down the line. In the meantime, this mechanism can be manually tested in the debug interface by creating a backup, which should also create an "archive.html" file in the backups folder. Using the "Extract from archive" button in the debug tool will let you select that HTML file and extract the ZIP as a file in the backups folder called "extraction.zip". 6. The test template contains Unicode characters because certain locales might involve us writing Unicode characters in the HTML template when generating the archive. The fun part about that is calculating where the byte offset is for the MIME block! See the comment in the Archive.worker.mjs script for how that works. Differential Revision: https://phabricator.services.mozilla.com/D211588
40 lines
1.4 KiB
Python
40 lines
1.4 KiB
Python
# -*- Mode: python; indent-tabs-mode: nil; tab-width: 40 -*-
|
|
# vim: set filetype=python:
|
|
# This Source Code Form is subject to the terms of the Mozilla Public
|
|
# License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
|
|
with Files("**"):
|
|
BUG_COMPONENT = ("Firefox", "Profiles")
|
|
|
|
JAR_MANIFESTS += ["jar.mn"]
|
|
|
|
SPHINX_TREES["docs"] = "docs"
|
|
|
|
XPCSHELL_TESTS_MANIFESTS += ["tests/xpcshell/xpcshell.toml"]
|
|
MARIONETTE_MANIFESTS += ["tests/marionette/manifest.toml"]
|
|
BROWSER_CHROME_MANIFESTS += ["tests/browser/browser.toml"]
|
|
MOCHITEST_CHROME_MANIFESTS += ["tests/chrome/chrome.toml"]
|
|
|
|
FINAL_TARGET_FILES.actors += [
|
|
"actors/BackupUIChild.sys.mjs",
|
|
"actors/BackupUIParent.sys.mjs",
|
|
]
|
|
|
|
EXTRA_JS_MODULES.backup += [
|
|
"Archive.worker.mjs",
|
|
"ArchiveEncryptionState.sys.mjs",
|
|
"ArchiveUtils.sys.mjs",
|
|
"BackupResources.sys.mjs",
|
|
"BackupService.sys.mjs",
|
|
"resources/AddonsBackupResource.sys.mjs",
|
|
"resources/BackupResource.sys.mjs",
|
|
"resources/CookiesBackupResource.sys.mjs",
|
|
"resources/CredentialsAndSecurityBackupResource.sys.mjs",
|
|
"resources/FormHistoryBackupResource.sys.mjs",
|
|
"resources/MiscDataBackupResource.sys.mjs",
|
|
"resources/PlacesBackupResource.sys.mjs",
|
|
"resources/PreferencesBackupResource.sys.mjs",
|
|
"resources/SessionStoreBackupResource.sys.mjs",
|
|
]
|