Angular项目中Azure Maps服务与动画API导入及类型报错咨询

• 报错原因：azure-maps-control 核心包未内置动画模块，动画能力属于独立的扩展包 azure-maps-animations，需要额外安装引入
• 操作步骤：
  1. 安装动画扩展包，执行命令：npm install azure-maps-animations
  2. TypeScript项目需要同步安装类型声明：npm install @types/azure-maps-animations --save-dev
  3. 在导入 azure-maps-control 的文件中额外引入动画模块：

  import * as atlas from 'azure-maps-control';
  import 'azure-maps-animations';
  

  引入后动画模块会自动挂载到 atlas 命名空间下，即可直接调用 atlas.animation 相关API。
• 临时兼容方案：如果安装后仍有类型提示错误，可以先通过 (atlas as any).animation.moveAlongRoute() 调用验证功能是否正常，再排查类型配置问题。

• 报错原因：azure-maps-rest 包的类型声明与当前TypeScript版本、或是其他Azure Maps相关包的版本不兼容，导致泛型约束校验不通过
• 操作步骤：
  1. 首先对齐所有Azure Maps相关依赖的版本，azure-maps-control、azure-maps-animations、azure-maps-rest 尽量使用同一大版本下的兼容版本，避免跨大版本混用
  2. 最快修复方案是在 tsconfig.json 的 compilerOptions 配置项中添加 "skipLibCheck": true，该配置只会跳过node_modules下第三方库的类型校验，不会影响业务代码的类型检查
  3. 若上述配置不生效，可以尝试降级TypeScript版本到4.8~4.9区间，Azure Maps系列包对TypeScript 5+的类型支持存在部分兼容问题，降级后可解决大多数类型冲突
  4. 也可以手动补充类型声明：在项目src目录下新建 typings.d.ts 文件，添加以下内容修复类型缺失或冲突：

  declare module 'azure-maps-control' {
    interface Atlas {
      animation: any;
    }
  }
  declare module 'azure-maps-rest' {
    export * from 'azure-maps-rest/typings';
  }
  

内容的提问来源于stack exchange，提问作者ANMOL SHARMA