前言
不知道从什么时候起,Bugly平台不再支持直接上传dSYM 符号表了,平台给的工具是真的难用,所以写了一个脚本,支持自动化-手动-半自动上传符号表,解放双手
- 判断java环境
java --version
- 安装java环境
brew install openjdk
3.官方套件下载地址
https://bugly.qq.com/v2/downloads
4.脚本
请将脚本中必填项补充完整
并将脚本和 buglyqq-upload-symbol.jar 放到同一目录下
#!/bin/bash
# 本脚本用于上传 iOS 应用符号表到 Bugly 平台。
# 请将本脚本和 buglyqq-upload-symbol.jar 放在同一目录下
# 请提前安装好java环境, brew install openjdk
# 执行命令:
# java -jar buglyqq-upload-symbol.jar -appid <APP ID>
# -appkey <APP KEY>
# -bundleid <App BundleID>
# -version <App Version>
# -buildNo <App Build Number>
# -platform <App Platform>
# -inputSymbol <Original Symbol File Path>
# -inputMapping <mapping file>
# 详细见 《符号表上传工具》
# 配置信息-必填
appName=""
appid=""
appkey=""
platform="IOS"
# ======下方字段为手动字段=======
# 当上传方式选择2时,需要手动配置 manual_bundleid 和 manual_version
# 除非使用BitCode,否则强烈建议使用1自动化方式上传
manual_bundleid=""
manual_version=""
# ============================
# 定义颜色变量
RED='\033[0;31m'
GREEN='\033[0;32m'
NC='\033[0m' # No Color
# 打印欢迎信息
function welcome_message() {
echo "${RED}"
echo "欢迎使用 $appName 应用符号表上传工具"
echo "请提前配置好脚本中的 appName/appid/appkey 三个必要字段"
echo "${GREEN}"
echo "脚本配置信息如下:"
echo "appName: $appName"
echo "appid: $appid"
echo "appkey: $appkey"
echo "${NC}"
echo "说明:"
echo "${RED}"
echo "1. 自动上传 -直接拖入 xcarchive 到控制台"
echo "2. 手动上传 -脚本中配置好 manual_bundleid 和 manual_version,并拖入dSYM文件到控制台"
echo "3. 半自动 -需要拖入 *.app 中的 Info.plist 和 dSYM文件到控制台"
echo "${NC}"
echo "请选择上传方式:"
echo "${RED}"
echo "1. 自动"
echo "2. 手动"
echo "3. 半自动"
echo "其他. 退出"
echo "${NC}"
}
# 检查是否安装了 Java
function check_java_installed() {
if ! command -v java &>/dev/null; then
echo "${RED}错误:Java 没有安装。请安装 Java 并重试。${NC}"
exit 1
fi
}
# 显示选项并获取用户选择
function get_user_choice() {
read -p "请输入选项 (1 或 2 或 3): " choice
echo $choice
}
# 从 info.plist 获取指定键的值
function get_plist_value() {
local plist_path="$1"
local key="$2"
/usr/libexec/PlistBuddy -c "Print :$key" "$plist_path" 2>/dev/null
}
# 自动上传流程
function automatic_upload() {
echo "${RED}打开Xcode->Window->Organizer${NC}"
echo "${RED}选择你的项目的Archives->右键Show in Finder${NC}"
echo "${RED}将 xcarchive 结尾的文件拖入到控制台${NC}"
read -p "请拖入xcarchive: " xcarchive_path
# 检查路径是否是文件夹且以 .xcarchive 结尾
if [[ ! -d "$xcarchive_path" || "$xcarchive_path" != *.xcarchive ]]; then
echo "${RED}错误:路径不是一个有效的.xcarchive 文件夹,请检查后重试。${NC}"
exit 1
fi
echo "${GREEN}xcarchive路径有效${NC}"
echo "${GREEN}$xcarchive_path${NC}"
echo ""
# 查找 dSYMs 中的 dSYM 文件
dSYM_path=$(find "$xcarchive_path/dSYMs" -maxdepth 1 -type d -name "*.dSYM")
if [ -z "$dSYM_path" ] || [ ! -d "$dSYM_path" ]; then
echo "${RED}错误:dSYM 文件不存在或路径无效,请检查输入是否正确。${NC}"
exit 1
fi
echo "${GREEN}dSYM文件路径有效:${NC}"
echo "${GREEN}$dSYM_path${NC}"
echo ""
# 查找 Products/Applications 中的 .app 目录
app_path=$(find "$xcarchive_path/Products/Applications" -maxdepth 1 -type d -name "*.app")
if [[ -z "$app_path" ]]; then
echo "${RED}错误:在 Products/Applications 中找不到 .app 目录。${NC}"
exit 1
fi
plist_path="$app_path/Info.plist"
if [[ ! -f "$plist_path" ]]; then
echo "${RED}错误:${app_path} 中的 Info.plist 文件不存在,请检查路径后重试。${NC}"
exit 1
fi
echo "${GREEN}Info.plist文件路径有效:${NC}"
echo "${GREEN}$plist_path${NC}"
echo ""
# 获取 bundleid, version, buildNo
bundleid=$(get_plist_value "$plist_path" "CFBundleIdentifier")
version=$(get_plist_value "$plist_path" "CFBundleShortVersionString")
buildNo=$(get_plist_value "$plist_path" "CFBundleVersion")
displayName=$(get_plist_value "$plist_path" "CFBundleDisplayName")
if [[ -z "$displayName" ]]; then
displayName=$(get_plist_value "$plist_path" "CFBundleName")
fi
# 检查是否成功获取所有必要的信息
if [[ -z "$bundleid" || -z "$version" || -z "$buildNo" ]]; then
echo "${RED}错误:从 Info.plist 中获取 bundleid, version 或 buildNo 失败。${NC}"
exit 1
fi
echo "${GREEN}"
echo "成功获取到以下信息:"
echo "displayName: ${displayName:-未定义}"
echo "bundleid: $bundleid"
echo "version: $version"
echo "buildNo: $buildNo"
echo "${NC}"
# 比较 displayName 和 appName
if [[ "$displayName" != "$appName" ]]; then
echo "${RED}脚本配置的名字是:$appName${NC}"
echo "${RED}自动获取的名字是:$displayName${NC}"
echo "${RED}请更新脚本中的appName字段${NC}"
read -p "两者出现不一致,是否继续?(y/N): " continue_choice
if [[ "$continue_choice" != "y" && "$continue_choice" != "Y" ]]; then
echo "${RED}用户选择不继续,退出程序。${NC}"
exit 1
fi
fi
read -p "即将执行上传符号表操作,是否继续?(y/N): " continue_choice
if [[ "$continue_choice" != "y" && "$continue_choice" != "Y" ]]; then
echo "${RED}用户选择不继续,退出程序。${NC}"
exit 1
fi
# 参数说明 -- Introduction for arguments
# -appid APP ID,可在bugly平台上查看
# -appkey APP Key,可在bugly平台上查看
# -version APP版本,务必和bugly平台上面看到的crash版本号保持一致
# -platform 平台类型包含 Android、IOS、MAC三个选项,注意大小写要正确
# -inputSymbol 原始符号表(ios平台是dsym/android平台是debug so)所在文件夹目录路径
# -inputMapping [Android平台特有,ios忽略] mapping文件路径或所在文件夹目录路径
# -buildNo [Android平台特有,ios忽略] 可选字段,只有当构建了多个相同版本号的apk,产生了多个mapping文件时,需要填写buildNo区分
echo "${GREEN}正在上传符号表...${NC}"
# 上传符号表
java -jar buglyqq-upload-symbol.jar -appid "$appid" -appkey "$appkey" -bundleid "$bundleid" -version "$version" -platform "$platform" -inputSymbol "$dSYM_path"
echo "${GREEN}上传结束${NC}"
}
# 手动上传流程
function manual_upload() {
# 在此处添加手动上传的相关代码
# 检查是否成功获取所有必要的信息
if [[ -z "$manual_bundleid" || -z "$manual_version" ]]; then
echo "${RED}错误:请在脚本中配置manual_bundleid 和 manual_version${NC}"
exit 1
fi
read -p "请拖入dSYM文件: " dSYM_path
# 检查是否输入了文件路径并且该路径指向一个有效的文件
if [ -z "$dSYM_path" ] || [ ! -d "$dSYM_path" ]; then
echo "${RED}错误:dSYM 文件不存在或路径无效,请检查输入是否正确。${NC}"
exit 1
fi
echo "${GREEN}"
echo "应用信息:"
echo "appName: $appName"
echo "bundleid: $manual_bundleid"
echo "version: $manual_version"
echo "${NC}"
read -p "即将执行上传符号表操作,是否继续?(y/N): " continue_choice
if [[ "$continue_choice" != "y" && "$continue_choice" != "Y" ]]; then
echo "${RED}用户选择不继续,退出程序。${NC}"
exit 1
fi
# 参数说明 -- Introduction for arguments
# -appid APP ID,可在bugly平台上查看
# -appkey APP Key,可在bugly平台上查看
# -version APP版本,务必和bugly平台上面看到的crash版本号保持一致
# -platform 平台类型包含 Android、IOS、MAC三个选项,注意大小写要正确
# -inputSymbol 原始符号表(ios平台是dsym/android平台是debug so)所在文件夹目录路径
# -inputMapping [Android平台特有,ios忽略] mapping文件路径或所在文件夹目录路径
# -buildNo [Android平台特有,ios忽略] 可选字段,只有当构建了多个相同版本号的apk,产生了多个mapping文件时,需要填写buildNo区分
echo "${GREEN}正在上传符号表...${NC}"
# 上传符号表
java -jar buglyqq-upload-symbol.jar -appid "$appid" -appkey "$appkey" -bundleid "$manual_bundleid" -version "$manual_version" -platform "$platform" -inputSymbol "$dSYM_path"
echo "${GREEN}上传结束${NC}"
}
# 半自动上传流程
function semi_automatic_upload() {
echo "${RED}请将 *.app 中的 Info.plist 文件拖入到控制台${NC}"
echo "${RED}请注意这里不是 *.xcarchive 中的Info.plist${NC}"
read -p "请拖入 Info.plist: " plist_path
# 检查是否输入了文件路径并且该路径指向一个有效的 Info.plist 文件
if [ -z "$plist_path" ] || [ ! -f "$plist_path" ]; then
echo "${RED}错误:Info.plist 文件不存在或路径无效,请检查输入是否正确。${NC}"
exit 1
fi
echo "${GREEN}Info.plist 文件路径有效${NC}"
bundleid=$(get_plist_value "$plist_path" "CFBundleIdentifier")
version=$(get_plist_value "$plist_path" "CFBundleShortVersionString")
buildNo=$(get_plist_value "$plist_path" "CFBundleVersion")
displayName=$(get_plist_value "$plist_path" "CFBundleDisplayName")
if [[ -z "$displayName" ]]; then
displayName=$(get_plist_value "$plist_path" "CFBundleName")
fi
# 检查是否成功获取所有必要的信息
if [[ -z "$bundleid" || -z "$version" || -z "$buildNo" ]]; then
echo "${RED}错误:从 Info.plist 中获取 bundleid, version 或 buildNo 失败。${NC}"
exit 1
fi
echo "${GREEN}成功获取到以下信息:${NC}"
echo "${GREEN}"
echo "displayName: ${displayName:-未定义}"
echo "bundleid: $bundleid"
echo "version: $version"
echo "buildNo: $buildNo"
echo "${NC}"
# 比较 displayName 和 appName
if [[ "$displayName" != "$appName" ]]; then
echo "${RED}脚本配置的名字是:$appName${NC}"
echo "${RED}自动获取的名字是:$displayName${NC}"
echo "${RED}请更新脚本中的appName字段${NC}"
read -p "两者出现不一致,是否继续?(y/N): " continue_choice
if [[ "$continue_choice" != "y" && "$continue_choice" != "Y" ]]; then
echo "${RED}用户选择不继续,退出程序。${NC}"
exit 1
fi
fi
read -p "请拖入dSYM文件: " dSYM_path
# 检查是否输入了文件路径并且该路径指向一个有效的文件
if [ -z "$dSYM_path" ] || [ ! -d "$dSYM_path" ]; then
echo "${RED}错误:dSYM 文件不存在或路径无效,请检查输入是否正确。${NC}"
exit 1
fi
echo "${GREEN}dSYM 文件路径有效${NC}"
read -p "即将执行上传符号表操作,是否继续?(y/N): " continue_choice
if [[ "$continue_choice" != "y" && "$continue_choice" != "Y" ]]; then
echo "${RED}用户选择不继续,退出程序。${NC}"
exit 1
fi
# 参数说明 -- Introduction for arguments
# -appid APP ID,可在bugly平台上查看
# -appkey APP Key,可在bugly平台上查看
# -version APP版本,务必和bugly平台上面看到的crash版本号保持一致
# -platform 平台类型包含 Android、IOS、MAC三个选项,注意大小写要正确
# -inputSymbol 原始符号表(ios平台是dsym/android平台是debug so)所在文件夹目录路径
# -inputMapping [Android平台特有,ios忽略] mapping文件路径或所在文件夹目录路径
# -buildNo [Android平台特有,ios忽略] 可选字段,只有当构建了多个相同版本号的apk,产生了多个mapping文件时,需要填写buildNo区分
echo "${GREEN}正在上传符号表...${NC}"
# 上传符号表
java -jar buglyqq-upload-symbol.jar -appid "$appid" -appkey "$appkey" -bundleid "$bundleid" -version "$version" -platform "$platform" -inputSymbol "$dSYM_path"
echo "${GREEN}上传结束${NC}"
}
# 主逻辑
function main() {
welcome_message
check_java_installed
choice=$(get_user_choice)
case $choice in
1)
echo "您选择了自动上传。"
automatic_upload
;;
2)
echo "您选择了手动上传。"
manual_upload
;;
3)
echo "您选择了半自动上传。"
semi_automatic_upload
;;
*)
echo "${RED}您输入的是: $choice${NC}"
echo "${RED}无效的选项,请输入 1 或 2 或 3。${NC}"
;;
esac
}
# 执行主逻辑
main