@nativescript-community/ui-carto

NativeScript 插件，用于 CARTO 移动 SDK

目录

• 安装
• API
• Svelte 中使用
  • 示例
• Vue 中使用
  • 示例
• 演示和开发
  • 仓库设置
  • 构建
  • 演示
• 贡献
  • 更新仓库
  • 更新 README
  • 更新文档
  • 发布
  • 修改子模块
• 问题

安装

从项目根目录运行以下命令

ns plugin add @nativescript-community/ui-carto

API

此插件的 API 文档可在 此处 查看。

Svelte 中使用

示例

• 基本栅格

Vue 中使用

示例

• 基本栅格

演示和开发

仓库设置

该仓库使用子模块。如果您没有使用 --recursive 进行克隆，则需要调用

git submodule update --init

用于安装和链接依赖项的包管理器必须是 pnpm 或 yarn。 npm 将无法正常工作。

开发和测试：如果您使用 yarn，则运行 yarn；如果您使用 pnpm，则运行 pnpm i

交互式菜单

要启动交互式菜单，请运行 npm start（或 yarn start 或 pnpm start）。这将列出所有常用脚本。

构建

npm run build.all

警告：似乎 yarn build.all 不会始终正常工作（在 node_modules/.bin 中找不到二进制文件），这就是为什么文档明确使用 npm run

演示

npm run demo.[ng|react|svelte|vue].[ios|android]

npm run demo.svelte.ios # Example

演示设置在某种程度上是特殊的，如果您想修改/添加演示，您不必直接在 demo-[ng|react|svelte|vue] 中工作。相反，您应该在 demo-snippets/[ng|react|svelte|vue] 中工作。您可以从每个版本的 install.ts 开始，了解如何注册新演示。

贡献

更新仓库

您可以非常容易地更新仓库文件。

首先更新子模块

npm run update

然后提交更改，然后更新公共文件

npm run sync

然后您可以运行 yarn|pnpm，如果有任何更改的文件，请提交

更新 README

npm run readme

更新文档

npm run doc

发布

发布完全由 lerna 处理（您可以使用 -- --bump major 强制发布主要版本）。只需运行

npm run publish

修改子模块

该仓库使用 https:// 用于子模块，这意味着您无法直接将子模块推送到子模块。一个简单的解决方案是修改 ~/.gitconfig 并添加

[url "ssh://[email protected]/"]
	pushInsteadOf = https://github.com/

问题

如果您有任何问题/问题/评论，请随时创建一个问题或开始在 NativeScript 社区 Discord 中进行对话。