@nativescript-community/ui-document-picker

一个 NativeScript 插件，允许您从设备中选择文件。

目录

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

安装

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

ns plugin add @nativescript-community/ui-document-picker

配置

在此处添加任何其他附加配置说明。

API

导出一个函数

export interface FilePickerOptions {
    extensions: string[];
    multipleSelection?: boolean;
    pickerMode?: number; //iOS only
}

export function openFilePicker(params: FilePickerOptions): Promise<{ files: string[]; ios?: NSURL; android?: android.net.Uri }>;

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 中进行对话。