LodashGS 项目使用教程

LodashGS 项目使用教程

lodashgs Lodash is a library that enables the use of the lodash.js library in Google Apps Script 项目地址: https://gitcode.com/gh_mirrors/lo/lodashgs

1. 项目的目录结构及介绍

LodashGS 项目的目录结构如下：

lodashgs/
├── build/
│   └── lodash.gs
├── src/
│   ├── clasp.json
│   ├── .gitignore
│   ├── .gitmodules
│   ├── CHANGELOG.md
│   ├── LICENSE
│   ├── README.md
│   ├── gulpfile.js
│   ├── package-lock.json
│   └── package.json
└── README.md

目录结构介绍

• build/: 包含构建后的文件，主要是 lodash.gs，这是在 Google Apps Script 中使用的 Lodash 库文件。
• src/: 包含项目的源代码和配置文件。
  • clasp.json: 用于配置 Google Apps Script 项目的文件。
  • .gitignore: 指定 Git 版本控制系统忽略的文件和目录。
  • .gitmodules: 用于管理 Git 子模块的配置文件。
  • CHANGELOG.md: 记录项目版本变更的日志文件。
  • LICENSE: 项目的开源许可证文件。
  • README.md: 项目的说明文档。
  • gulpfile.js: 用于自动化构建任务的 Gulp 配置文件。
  • package-lock.json: 锁定项目依赖版本的文件。
  • package.json: 项目的 npm 配置文件，包含项目的依赖和脚本。

2. 项目的启动文件介绍

LodashGS 项目的启动文件主要是 build/lodash.gs。这个文件是经过构建后的 Lodash 库文件，可以直接在 Google Apps Script 项目中使用。

启动文件介绍

• build/lodash.gs: 这是 Lodash 库的核心文件，包含了 Lodash 的所有功能。你可以通过以下方式在 Google Apps Script 项目中加载这个库：

  var _ = LodashGS.load();
  

  或者在 ES6+ 环境中：

  const _ = LodashGS.load();
  

3. 项目的配置文件介绍

LodashGS 项目中有多个配置文件，主要用于项目的构建、依赖管理和版本控制。

配置文件介绍

• clasp.json: 这个文件用于配置 Google Apps Script 项目。它包含了项目的 ID 和其他相关配置。

  {
    "scriptId": "your-script-id",
    "rootDir": "build"
  }
  

• package.json: 这个文件包含了项目的依赖和脚本。你可以通过 npm install 安装依赖，并通过 npm run build 运行构建脚本。

  {
    "name": "lodashgs",
    "version": "1.0.0",
    "description": "Lodash for Google Apps Script",
    "main": "build/lodash.gs",
    "scripts": {
      "build": "gulp build"
    },
    "dependencies": {
      "lodash": "^4.17.21"
    }
  }
  

• gulpfile.js: 这个文件用于配置 Gulp 构建任务。它定义了如何将 Lodash 库构建为适用于 Google Apps Script 的格式。

  const gulp = require('gulp');
  const concat = require('gulp-concat');
  
  gulp.task('build', function() {
    return gulp.src('src/**/*.js')
      .pipe(concat('lodash.gs'))
      .pipe(gulp.dest('build'));
  });
  

通过这些配置文件，你可以轻松地管理和构建 LodashGS 项目，并在 Google Apps Script 中使用 Lodash 库。

lodashgs Lodash is a library that enables the use of the lodash.js library in Google Apps Script 项目地址: https://gitcode.com/gh_mirrors/lo/lodashgs