从App Script库发布Google Docs计算类Add-On至Marketplace的技术问题咨询

我来帮你逐个解决这些Google Workspace Add-On发布的问题，这些都是我开发Add-On时踩过的实打实的坑：

1. 卡片侧边栏图标无法显示的解决方法 #

你当前用的Google Drive分享链接是预览链接，不是直接可访问的图片资源URL，Google Workspace Add-On的logoUrl要求必须是能直接加载的图片地址，按以下步骤调整：

• 先确保你的PNG文件在Google Drive中设置为**「任何人，即使没有链接也可查看」**的权限（右键文件→分享→更改权限→选择“任何人都可查看”）
• 把原链接转换成直接访问格式：
  原链接：https://drive.google.com/file/d/1ZFzKwFj55eR8aTD1A72E_f5s3ew-xSZH/view?usp=sharing
  修改为：https://drive.google.com/uc?id=1ZFzKwFj55eR8aTD1A72E_f5s3ew-xSZH
  （或者加上导出参数确保图片格式：https://drive.google.com/uc?id=1ZFzKwFj55eR8aTD1A72E_f5s3ew-xSZH&export=view）
• 替换appscript.json里的logoUrl为这个新地址，重新部署Add-On即可

另外提个小建议：侧边栏图标推荐用128x128px的尺寸，Marketplace图标用256x256px，避免缩放变形。

2. 发布后无Add-On菜单项及函数报错问题 #

这个问题核心是库的依赖配置、函数可见性和触发器逻辑出了问题，分两部分排查：

菜单项不显示的解决步骤 #

• 检查calcPadOnOpen函数的位置：这个生成菜单的关键函数，必须存在于Add-On的主脚本项目中（不能只放在库里面），如果库中有这个函数，主脚本里必须写一个调用它的包装函数
• 统一清单文件的触发器配置：你当前common.homepageTrigger指向calcPadOnOpen，但docs.homepageTrigger指向showSideBar，建议Docs的触发器也指向菜单生成函数，确保打开文档时能触发菜单加载
• 测试授权流程：首次打开文档时，用户需要授权Add-On权限，授权完成后菜单才会显示，你可以用隐身窗口模拟新用户的体验，排查是否是授权环节的问题

函数找不到报错的解决步骤 #

• 库的权限与版本设置：你的CalcPad库必须设置为**「任何人，即使没有链接也可查看」，并且要部署一个稳定版本**（不要用开发版本），在主脚本的「资源→库」中选择这个稳定版本
• 补充清单的依赖配置：你当前的dependencies是空的，需要把库的ID和版本加进去，示例如下：

  "dependencies": {
    "libraries": [{
      "userSymbol": "CalcPad",
      "libraryId": "你的库的唯一ID",
      "version": "库的稳定版本号"
    }]
  }
  

• 确认函数可见性：库中的CPObject、showSideBar、calculate等函数必须是全局公开函数（不能用var/let定义成局部函数），比如库中要这样写：

  function showSideBar() {
    // 你的函数逻辑
  }
  

• 检查拼写错误：你示例里的包装函数写的是CalcPad.showSiddeBar()（多了一个d），这种低级拼写错误会直接导致调用失败，先把所有函数名核对一遍

3. 库函数调用与google.script.run的优化方案 #

google.script.run有个硬性限制：只能直接调用当前脚本项目（Add-On主脚本）中的全局函数，无法直接调用库中的函数，这里给你两个实用的优化方案：

方案1：自动生成包装函数（推荐） #

在库中写一个函数，用来自动在主脚本中生成所有需要的包装函数，这样就不用手动一个个写了：

// 库中的函数：自动生成包装函数
function generateWrapperFunctions() {
  const wrapperCode = `
function showSideBar() {
  try {
    return CalcPad.showSideBar();
  } catch(err) {
    throw "Error in CalcPad.showSideBar: "+err;
  }
}
function calculate() {
  try {
    return CalcPad.calculate();
  } catch(err) {
    throw "Error in CalcPad.calculate: "+err;
  }
}
// 其他需要暴露给google.script.run的函数...
`;
  // 将代码写入主脚本项目（需要主脚本有编辑权限）
  const mainScriptId = ScriptApp.getScriptId();
  DriveApp.getFileById(mainScriptId).setContent(wrapperCode);
}

在主脚本的onOpen中调用一次这个函数（生成后就可以注释掉），就能自动生成所有需要的包装函数。

方案2：将库合并到Add-On主项目 #

如果你的库已经稳定，没有其他项目依赖它，直接把库中的所有代码复制到Add-On的主脚本项目中是最省心的做法——这样google.script.run可以直接调用所有函数，完全避免包装函数的麻烦，这也是Google官方推荐的Add-On发布方式（减少依赖，避免库版本冲突）。

内容的提问来源于stack exchange，提问作者TheWizEd