开源项目 `zxing-js/ngx-scanner` 使用教程

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

zxing-js/ngx-scanner 是一个用于 Angular 的条形码扫描器库。项目的目录结构如下：

zxing-js/ngx-scanner/
├── e2e/
│   ├── src/
│   │   ├── app.e2e-spec.ts
│   │   └── app.po.ts
│   ├── protractor.conf.js
│   └── tsconfig.json
├── projects/
│   └── ngx-scanner/
│       ├── src/
│       │   ├── lib/
│       │   │   ├── ngx-scanner.component.ts
│       │   │   ├── ngx-scanner.module.ts
│       │   │   └── ...
│       │   ├── public-api.ts
│       │   └── ...
│       ├── karma.conf.js
│       ├── package.json
│       ├── tsconfig.lib.json
│       └── tsconfig.spec.json
├── src/
│   ├── app/
│   │   ├── app.component.css
│   │   ├── app.component.html
│   │   ├── app.component.spec.ts
│   │   ├── app.component.ts
│   │   └── app.module.ts
│   ├── assets/
│   ├── environments/
│   │   ├── environment.prod.ts
│   │   └── environment.ts
│   ├── index.html
│   ├── main.ts
│   ├── styles.css
│   └── ...
├── angular.json
├── package.json
├── tsconfig.json
└── ...

目录结构介绍

• e2e/: 包含端到端测试的文件。
• projects/: 包含库项目的源代码。
  • ngx-scanner/: 条形码扫描器库的主要代码。
    • src/lib/: 包含库的核心组件和模块。
• src/: 包含示例应用的源代码。
  • app/: 示例应用的主要代码。
  • assets/: 静态资源文件。
  • environments/: 环境配置文件。
• angular.json: Angular 项目的配置文件。
• package.json: 项目的依赖管理文件。
• tsconfig.json: TypeScript 配置文件。

2. 项目的启动文件介绍

项目的启动文件是 src/main.ts，它是 Angular 应用的入口点。以下是 main.ts 的内容：

import { enableProdMode } from '@angular/core';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';

import { AppModule } from './app/app.module';
import { environment } from './environments/environment';

if (environment.production) {
  enableProdMode();
}

platformBrowserDynamic().bootstrapModule(AppModule)
  .catch(err => console.error(err));

启动文件介绍

• enableProdMode(): 在生产环境中启用生产模式。
• platformBrowserDynamic(): 使用 JIT 编译器启动 Angular 应用。
• bootstrapModule(AppModule): 引导启动 AppModule 模块。

3. 项目的配置文件介绍

项目的配置文件主要包括 angular.json 和 tsconfig.json。

angular.json

angular.json 是 Angular 项目的配置文件，包含了项目的基本配置、构建配置、测试配置等。以下是部分内容：

{
  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
  "version": 1,
  "newProjectRoot": "projects",
  "projects": {
    "ngx-scanner-demo": {
      "projectType": "application",
      "schematics": {},
      "root": "",
      "sourceRoot": "src",
      "prefix": "app",
      "architect": {
        "build": {
          "builder": "@angular-devkit/build-angular:browser",
          "options": {
            "outputPath": "dist/ngx-scanner-demo",
            "index": "src/index.html",
            "main