CAA Authorized APIs -已授权 API 及其使用与管控迁移

摘要

CAA 授权应用程序接口现已存放于各框架的 PublicInterfaces 目录下。此外，原有的 AuthorizedAPI.txt 文本文件现已加密为 AuthorizedAPI.script 文件提供。本文将对上述变更进行说明，并给出相关技巧与建议，以帮助您基于这些授权应用程序接口顺利开展应用程序开发工作。

CAA 授权应用程序接口位置变更概述

• CAA 授权应用程序接口的位置
• RADE 安装目录下 \tools\config 路径中的 AuthorizedAPI 文件

CAA 授权 API 位置变更简述

从 CAA V5R12 版本开始，授权 API 逐步迁移至各框架的 PublicInterfaces 目录下。

CAA 授权 API 的位置

 截至 V5R11 版本，框架中的 CAA 授权 API 与达索系统（DS）内部资源主要位于该框架的 ProtectedInterfaces 目录下。通过打开相关文件查找 CAA 公开标记，或查阅 CAA 百科全书，即可区分授权 API 与达索系统内部资源。

从 V5R12 版本开始，CAA 授权 API 逐步迁移至 PublicInterfaces 目录，而达索系统（DS）内部资源则保留在 ProtectedInterfaces 目录中。

RADE 安装目录下 \tools\config 中的 AuthorizedAPI 文件

截至 V5R11 版本，**AuthorizedAPI.txt** 文件未做安全保护。 只有在达索系统（Dassault Systèmes）技术支持的协助下，才能修改该文件，以允许在 CAA 应用程序中使用达索系统内部资源。截至 V5R11 版本，AuthorizedAPI.txt 文件未做安全保护。只有在达索系统（Dassault Systèmes）技术支持的协助下，才能修改该文件，以允许在 CAA 应用程序中使用达索系统内部资源。siudasiodopasidp截至 V5R11 版本，**AuthorizedAPI.txt** 文件未做安全保护。 只有在达索系统（Dassault Systèmes）技术支持的协助下，才能修改该文件，以允许在 CAA 应用程序中使用达索系统内部资源。

截至 V5R11 版本，AuthorizedAPI.txt 文件未做安全保护。只有在达索系统（Dassault Systèmes）技术支持的协助下，才能修改该文件，以允许在 CAA 应用程序中使用达索系统内部资源。

 从 V5R12 版本开始，AuthorizedAPI.txt 文件采用加密形式提供，并更名为 AuthorizedAPI.script，该文件无法被修改。

为帮助开发者仅使用授权 API，mkmk 工具会检查 CAA 应用程序是否仅调用授权 API，若使用了达索系统（DS）内部资源则会抛出错误。但该检查属于事后纠错型检查，而非事前预判型检查，这会迫使 CAA 开发者在应用程序准备构建时，返工修改代码，甚至可能需要调整设计方案。

严禁使用 DS 内部资源，具体原因如下：

• DS 内部资源未收录在 CAA 百科全书文档中
• 位于 PublicInterfaces 目录下的 DS 内部资源会带有以下标记：
  • @nodoc
  • @CAA2Required：此类资源仅为间接引用（CAA 应用中无需显式包含），禁止直接调用
• 位于 ProtectedInterfaces 文件夹下的 DS 内部资源无任何标记

可查阅 CAA 百科全书，了解 CAA V5 授权 API 的使用规范、弃用说明及稳定性相关内容 [2]。