跳转至正文

启动 Navigator Capacitor 插件

打开 Google Maps 或 Apple Maps 等导航应用,获取前往目的地的路线

安装

bun add @capgo/capacitor-launch-navigator bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-launch-navigator
  • pnpm add @capgo/capacitor-launch-navigator
  • yarn add @capgo/capacitor-launch-navigator

指南

如何在 Capacitor 中使用 Launch Navigator

在设备上测试

下载 Capgo App,然后扫描二维码 code。

Launch Navigator 插件预览二维码 code

使用 @capgo/capacitor-launch-navigator

插件主界面。

安装

bun add @capgo/capacitor-launch-navigator
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

API 概览

方法 描述
navigate 通过经纬度导航至指定位置。
isAppAvailable 检查特定的导航应用是否可用。
getAvailableApps 获取设备上可用的导航应用列表。
getSupportedApps 获取当前平台支持的应用列表。
getDefaultApp 获取默认导航应用的名称。
getAppIcons 获取供应商图标并进行本地缓存。
refreshAppIcons 刷新供应商图标,忽略缓存有效期。
clearIconCache 清除已缓存的供应商图标。

示例

navigate()

通过经纬度导航至指定位置。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

await LaunchNavigator.navigate({ destination: [48.8566, 2.3522] });

isAppAvailable()

检查特定的导航应用是否可用。

import { LaunchNavigator, IOSNavigationApp } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.isAppAvailable({ app: IOSNavigationApp.APPLE_MAPS });
console.log(result);

getAvailableApps()

获取设备上可用的导航应用列表。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getAvailableApps();
console.log(result);

getSupportedApps()

获取当前平台支持的应用列表。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getSupportedApps();
console.log(result);

getDefaultApp()

获取默认导航应用的名称。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getDefaultApp();
console.log(result);

getAppIcons()

获取服务商图标并进行本地缓存。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getAppIcons();
console.log(result);

上表列出了 8 个核心方法。监听器、版本辅助函数以及每个方法的完整契约,请参阅 GitHub 仓库.

完整参考文档

继续阅读 使用 @capgo/capacitor-launch-navigator

如果你正在使用 使用 @capgo/capacitor-launch-navigator 要规划原生插件工作,请将其与 @capgo/capacitor-launch-navigator 有关 @capgo/capacitor-launch-navigator 的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节,以及 添加或更新插件 有关添加或更新插件的实现细节。

常见问题

Launch Navigator 插件常见问题

如何在 Capacitor 应用中安装 Launch Navigator 插件?

运行 "bun add @capgo/capacitor-launch-navigator" (或 "npm install @capgo/capacitor-launch-navigator"),然后运行 "bunx cap sync",以便 iOS 和 Android 项目同步原生的 code。最后在你的应用 code 中从 "@capgo/capacitor-launch-navigator" 导入即可。

@capgo/capacitor-launch-navigator 是否支持 React、Vue 和 Angular?

支持。Launch Navigator 是一个 Capacitor 插件,因此它支持任何在 Capacitor 中运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 以及原生 JavaScript。

@capgo/capacitor-launch-navigator 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-launch-navigator 是免费开源的吗?

是的。code 的源码已在 GitHub 公开,地址为 https://github.com/Cap-go/capacitor-launch-navigator/,并且你可以通过 npm 免费安装该包。欢迎提交 Bug 报告和 Pull Request。

我能否在无需经过 App Store 审核的情况下,更新使用了 Launch Navigator 的 code?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App Store 审核,即可快速发布 Launch Navigator 的变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo