Oracle JET 项目教程

Oracle JET 项目教程

1. 项目目录结构及介绍

Oracle JET（JavaScript Extension Toolkit）是一个面向中级到高级JavaScript开发者的模块化工具包，用于构建与Oracle产品和服务，特别是Oracle云服务交互的客户端应用程序。以下是项目的目录结构及各部分的简要介绍：

oraclejet/
├── dist/                # 存放编译后的文件和资源
├── examples/            # 包含示例应用程序和组件
├── lib/                 # Oracle JET 核心库文件
├── packages/            # 包含可复用的Oracle JET组件
├── src/                 # 源代码目录，包含所有JavaScript、CSS和HTML文件
│   ├── components/      # UI组件源文件
│   ├── data/            # 数据模型和模拟数据文件
│   ├── models/          # 应用程序模型
│   ├── views/           # 应用程序视图
│   └── ...
├── test/                # 单元测试和集成测试代码
├── .eslintrc.js         # ESLint 配置文件
├── .gitignore           # 指定Git应该忽略的文件和目录
├── .travis.yml          # Travis CI持续集成配置文件
├── CONTRIBUTING.md      # 贡献指南
├── LICENSE.txt          # 项目许可证
├── README.md            # 项目描述文件
├── SECURITY.md          # 安全策略
├── THIRDPARTYLICENSE.txt# 第三方许可证
├── package.json         # 项目配置文件
└── ...

2. 项目的启动文件介绍

项目的启动通常是通过命令行界面（CLI）进行。以下是一些基本的启动命令：

• 安装全局CLI工具：

npm install -g @oracle/ojet-cli

• 创建一个新的Oracle JET应用程序：

ojet create <app name>

• 运行应用程序：

ojet run

启动文件通常是index.html，位于项目的src目录下的views文件夹中。这个HTML文件是应用程序的入口点，它加载了Oracle JET库和应用程序的主要JavaScript文件。

3. 项目的配置文件介绍

项目的配置主要通过package.json文件进行。以下是package.json的一些关键字段：

• name: 项目的名称。
• version: 项目的版本号。
• description: 项目的简短描述。
• main: 指定应用程序的主要入口文件。
• scripts: 定义了一组可以运行的脚本，例如启动开发服务器或构建应用程序。
• dependencies: 列出了项目依赖的库。
• devDependencies: 列出了开发过程中依赖的库。

例如：

{
  "name": "oraclejet-app",
  "version": "1.0.0",
  "description": "An Oracle JET application",
  "main": "index.js",
  "scripts": {
    "start": "ojet run",
    "build": "ojet build"
  },
  "dependencies": {
    "@oracle/oraclejet": "^5.0.0"
  },
  "devDependencies": {
    "ojet-cli": "^5.0.0"
  }
}

这个配置文件为npm脚本提供了指令，使得开发者可以轻松地运行和构建他们的Oracle JET应用程序。