README

hcore/cli

HCore 命令行工具

hcore/cli 使用 Composer 管理其依赖。因此，在使用 HCore/CLI 之前，请确保您的机器上已安装 Composer。

首先，使用 Composer 下载 HCore/CLI

composer global require hcore/cli

来更新 HCore/CLI 到最新版本

composer global update hcore/cli

请确保将 Composer 的系统级 vendor bin 目录放置在您的 $PATH 中，以便系统可以找到 hcore 可执行文件。该目录根据您的操作系统位于不同的位置；然而，一些常见的位置包括

• macOS 和 GNU / Linux 发行版: $HOME/.composer/vendor/bin
• Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

在某些 Windows 计算机上，全局 Composer 文件夹可能不同。您可以通过运行此命令来查询 Composer，找到它已设置的用户 $COMPOSER_HOME 目录：

composer global config home 

UNIX / Linux: 使用 export 命令设置您的 PATH 变量

echo 'export PATH="$PATH:$HOME/.config/composer/vendor/bin"' >> ~/.bashrc
source ~/.bashrc

文档

• 简介
• 用法
• 创建您的应用程序
• 模块
• 小部件覆盖

简介

hcore/cli 是 HCore 包含的命令行界面。它提供了一些有用的命令，供您在开发应用程序时使用。

用法

列出所有可用命令

要查看所有可用 hcore/cli 命令的列表，您可以使用 "-h, --help" 选项

hcore -h

查看某个命令的帮助屏幕

每个命令还包括一个 "帮助" 屏幕，显示并描述命令的可用参数和选项。要查看帮助屏幕，只需在命令名称前加上 help

hcore create help

显示当前 hcore/cli 版本

您还可以使用 "-V, --version" 选项查看 hcore/cli 安装当前版本

hcore -V

创建您的应用程序

要创建自己的项目，请转到项目文件夹并运行此命令

hcore create <your-project-name>

该命令将询问您是否想要下载额外的模块（默认情况下会下载）。

按照说明在 BitBucket 账户的设置中创建您的消费者密钥，并输入所需的关键字和密钥。

执行结束时，将创建项目结构。

注意：有时 BitBucket OAuth 可能无法正常工作。在这种情况下，首先启动此命令：

composer clearcache

自定义分支

您可以选择从哪个分支克隆依赖项（默认为 ^0.4）。要指定您的自定义分支，请添加 "-b, --branch" 选项

示例

hcore create <your-project-name> --branch dev-release/0.3.x

注意：自定义分支不会传播到模块。

require-dev

创建 composer.json 后的命令将启动 "composer install"，而不包含 require-devs。要包含这些，请添加 "-d, --dev" 选项

仅生成 composer.json 而不安装

如果您想使命令仅生成 composer.json 文件，请添加 "-j, --json" 选项。

模块

您可以在安装后添加或删除模块。

• 要删除现有模块，请运行此命令

    hcore module:remove <module_name>
  
    // Example:
  
    hcore module:remove dmr
    hcore module:remove uploader
  
  

• 要添加新的 hcore 模块，请运行此命令

    hcore module:add <module_name>
  
    // Example:
      
    hcore module:add auth 
    hcore module:add uploader
  

小部件覆盖

要覆盖小部件，请使用此命令

hcore widget:create <module/widget>

其中 "module/widget" 是小部件路径。例如，如果您想覆盖登录小部件，请运行

hcore widget:create auth/login

如果只指定了模块，则所有模块的小部件都将被覆盖

hcore widget:create auth