__CAPGO_KEEP_0__ __CAPGO_KEEP_1__

启动导航器 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

在设备上测试

下载Capgo应用,扫描二维码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插件目录中获取产品工作流程 Capacitor Capgo 的插件 为 Capacitor Capgo 的实现细节, 添加或更新插件 为添加或更新插件的实现细节。

常见问题

Launch Navigator 插件常见问题

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

Run "bun add @capgo/capacitor-launch-navigator" (or "npm install @capgo/capacitor-launch-navigator"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-launch-navigator" in your app code.

@capgo/capacitor-launch-navigator 与 React、Vue 和 Angular 是否兼容?

是的。Launch Navigator 是一个 Capacitor 包,因此它与任何运行在 Capacitor 内的 web 框架兼容,包括 Ionic、React、Vue、Angular、Svelte 和普通 JavaScript。

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

Capgo 插件遵循 Capacitor 的主要版本:使用与 Capacitor 主要版本匹配的插件主要版本(例如插件 v8 与 Capacitor 8)。在 GitHub README 中的兼容性表格中列出了维护的版本。

@capgo/capacitor-launch-navigator 是否免费和开源?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-launch-navigator/ and the package is free to install from npm. Bug reports and pull requests are welcome.

是否可以在不经过 App Store 审核的情况下更新使用 Launch Navigator 的 code?

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

不用等待App Store审查就可以推送Launch Navigator更新

在您的商店构建中安装插件后,Capgo即刻更新将您的JavaScript、HTML和CSS更改推送给用户。

使用Capgo