e9a3071adb
This passes the `--pretty` flag to the symbolication script, which slightly improves readability. I also switched the flags to their long forms (`--output` instead of `-o`, for example) because I feel that they're more readable. But that's stylistic, and shouldn't affect the functionality of the script.
112 lines
3.0 KiB
Python
Executable File
112 lines
3.0 KiB
Python
Executable File
#!/usr/bin/env python3
|
||
|
||
import argparse
|
||
import json
|
||
import os
|
||
import subprocess
|
||
import sys
|
||
|
||
ENV_NAME = "SIGNAL_IOS_DSYMS"
|
||
|
||
|
||
def run(args):
|
||
return subprocess.run(
|
||
args, capture_output=True, check=True, encoding="utf8"
|
||
).stdout.rstrip()
|
||
|
||
|
||
def parse_args():
|
||
parser = argparse.ArgumentParser(
|
||
description=(
|
||
"Symbolicates .ips files passed as arguments. "
|
||
"The symbolicated file is written to *.symbolicated.ips. "
|
||
f"The script assumes you’ve saved the dSYM files in ${ENV_NAME}."
|
||
)
|
||
)
|
||
parser.add_argument(
|
||
"--open",
|
||
"-o",
|
||
action="store_true",
|
||
help="Open files after they’re symbolicated.",
|
||
)
|
||
parser.add_argument(
|
||
"path",
|
||
nargs="+",
|
||
metavar="log.ips",
|
||
help="Paths to files that should be symbolicated.",
|
||
)
|
||
return parser.parse_args()
|
||
|
||
|
||
def get_version(path):
|
||
with open(path, "r") as file:
|
||
content = file.read()
|
||
|
||
_, _, remainder = content.partition("\n")
|
||
try:
|
||
# The new format has a second JSON payload.
|
||
json.loads(remainder)
|
||
return 2
|
||
except json.decoder.JSONDecodeError:
|
||
return 1
|
||
|
||
|
||
SCRIPT_PATH_V1 = "Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash"
|
||
|
||
|
||
def symbolicate_v1(xcode_path, path, output_path):
|
||
script_path = os.path.join(xcode_path, SCRIPT_PATH_V1)
|
||
args = [script_path, path]
|
||
env = {**os.environ, "DEVELOPER_DIR": xcode_path}
|
||
with open(output_path, "wb") as file:
|
||
subprocess.run(args, check=True, stdout=file, env=env)
|
||
|
||
|
||
SCRIPT_PATH_V2 = "Contents/SharedFrameworks/CoreSymbolicationDT.framework/Resources/CrashSymbolicator.py"
|
||
|
||
|
||
def symbolicate_v2(xcode_path, path, output_path):
|
||
script_path = os.path.join(xcode_path, SCRIPT_PATH_V2)
|
||
# Don’t put this on the Desktop or in Documents -- the script can’t find it there.
|
||
# This directory is searched recursively for .dSYM files.
|
||
symbols_path = os.getenv(ENV_NAME)
|
||
if symbols_path is None or not os.path.exists(symbols_path):
|
||
print(
|
||
f"\nThe {ENV_NAME} environment variable should be set to a directory containing .dSYM files.\n",
|
||
file=sys.stderr,
|
||
)
|
||
exit(1)
|
||
args = [
|
||
"python3",
|
||
script_path,
|
||
"--dsym",
|
||
symbols_path,
|
||
"--output",
|
||
output_path,
|
||
"--pretty",
|
||
path,
|
||
]
|
||
subprocess.run(args, check=True)
|
||
|
||
|
||
def main():
|
||
ns = parse_args()
|
||
|
||
dev_path = run(["xcode-select", "-p"])
|
||
xcode_path = os.path.normpath(os.path.join(dev_path, *([os.pardir] * 2)))
|
||
|
||
for path in ns.path:
|
||
version = get_version(path)
|
||
base, ext = os.path.splitext(path)
|
||
output_path = base + ".symbolicated" + ext
|
||
if version == 2:
|
||
symbolicate_v2(xcode_path, path, output_path)
|
||
else:
|
||
symbolicate_v1(xcode_path, path, output_path)
|
||
if ns.open:
|
||
subprocess.run(["open", output_path], check=True)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|