Gas-Clasp-Starter 项目启动与配置教程

1. 项目目录结构及介绍

Gas-Clasp-Starter 项目的目录结构如下：

gas-clasp-starter/
├── .clasp.json
├── .vscode
│   └── settings.json
├── apps
│   └── script.js
├── clasp.json
├── manifest.json
├── node_modules
│   └── ... (Node.js依赖包)
├── package-lock.json
├── package.json
├── src
│   └── ... (源代码文件)
└── test
    └── ... (测试代码文件)

• .clasp.json：Clasp 的配置文件，用于存储 Google Apps Script 的项目信息和授权。
• .vscode：Visual Studio Code 的配置文件夹，包含项目特定的设置。
• apps：包含主要的 Apps Script 代码文件。
• clasp.json：Clasp 的配置文件，用于定义项目的部署设置。
• manifest.json：Google Apps Script 项目的配置文件，定义了应用程序的标题、描述、权限等。
• node_modules：Node.js 的依赖包文件夹。
• package-lock.json：记录了 Node.js 项目依赖的精确版本。
• package.json：定义了 Node.js 项目的配置信息和依赖。
• src：源代码文件夹，通常包含项目的 JavaScript 代码。
• test：测试代码文件夹，用于存放单元测试和其他测试脚本。

2. 项目的启动文件介绍

apps/script.js 是项目的主要启动文件。这个文件包含了 Google Apps Script 的代码，它将运行在你的 Google 表单、文档或其他支持 Google Apps Script 的服务中。以下是启动文件的基本结构：

function myFunction() {
  // 在这里编写你的代码
}

function myOtherFunction() {
  // 在这里编写你的代码
}

在这个文件中，你可以定义各种函数，它们可以通过在 Google Apps Script 编辑器中运行 Run 菜单来执行。

3. 项目的配置文件介绍

manifest.json

manifest.json 文件用于配置 Google Apps Script 项目的基本信息，例如：

{
  "timeZone": "America/New_York",
  "dependencies": {
    "enabled": true,
    "urls": [
      "https://ssl.gstatic.com/docs/script cupid/kindred.v1.js"
    ]
  },
  "exceptionLogging": "STACKDRIVER",
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.external",
    "https://www.googleapis.com/auth/spreadsheets.readonly"
  ],
  "appVersion": "1.0.0",
  "IORules": [],
  "addOns": {
    "common": {
      "name": "My App",
      "logoUrl": "https://www.example.com/logo.png",
      "layoutProperties": {
        "primaryColor": "#4285F4",
        "secondaryColor": "#D3E3FC"
      }
    }
  }
}

在这个文件中，你可以设置项目的时间区域、依赖项、异常日志记录方式、OAuth 权限范围、应用版本信息、界面布局属性等。

.clasp.json

.clasp.json 文件是 Clasp 工具的配置文件，它存储了与 Google Apps Script 项目交互的必要信息。例如：

{
  "scriptId": "1234567890abcdef12345678",
  "tokens": {
    "refresh_token": "your-refresh-token",
    "access_token": "your-access-token",
    "token_type": "Bearer",
    "expires_at": 1630000000
  }
}

在这个文件中，scriptId 是你的 Google Apps Script 项目的唯一标识符，tokens 包含了用于身份验证的访问令牌和刷新令牌。这些信息通常在项目部署和交互过程中自动生成和管理。