本文介绍了如何在 RuiChing Studio 中创建一个目录操作示例，并将其编译后在开发板上运行。旨在帮助读者进一步熟悉 RuiChing Studio 开发环境，掌握 目录的创建和删除。

目录创建与删除

本示例以演示在 /data 目录下创建和删除 example_dir 目录的操作，展示创建目录时目录已存在创建失败、删除目录时目录不存在删除失败的情况为实践目标，实现在指定目录创建和删除目录，且根据目录存在与否呈现不同操作结果的演示效果。

创建工程点击展开

1. 依次点击 “文件” -> “新建” -> "RT-Thread RuiChing App 项目"。

   

2. 在弹出新建向导中选择 开发版 、BSP: 、示例 、 调试器/下载器。选择好之后点击 “完成”。

   

3. 点击 “完成” 后，等待工程创建完成。

   

4. 创建完成。

   

构建工程点击展开

1. 单击工程使工程进入 Active-Debug 模式。

   

2. 点击工具栏上的构建按钮进行工程编译。

   

3. 构建成功后，会显示构建成功的信息。

   

固件下载点击展开

1. 固化设备树

   

2. 固化 APP

   

核心示例代码

dir 示例相关 API

• mkdir：用于创建一个新的目录，第一个参数 EXAMPLE_DIR 是要创建目录的路径，第二个参数 0 是目录的权限模式；
• unlink：用于删除文件或符号链接；

applications/mkdir_example.c

static int mkdir_example(void)
{
    rt_err_t ret;

    ret = mkdir(EXAMPLE_DIR, 0); // 创建目录
    if (ret)
    {
        LOG_E("Failed to create the \"example_dir\" folder.");
        goto __exit;
    }

    LOG_I("The \"example_dir\" folder was created successfully.");

__exit:
    return ret;
}
MSH_CMD_EXPORT(mkdir_example, mkdir example);
static int rmdir_example(void)
{
    rt_err_t ret;

    ret = unlink(EXAMPLE_DIR); // 删除目录
    if (ret)
    {
        LOG_E("The deletion of the \"example_dir\" folder failed.");
        goto __exit;
    }

    LOG_I("The deletion of the \"example_dir\" folder was successful.");

__exit:
    return ret;
}
MSH_CMD_EXPORT(rmdir_example, rmdir example);

运行示例

操作步骤

开发板运行程序后，在终端输入 mkdir_example 命令，示例运行成功后可以通过命令 ls /data 查看创建的目录。

msh />mkdir example
[I/example.mkdir] The "example_dir" folder was created successfully.
msh />ls /data
Directory /data:
example_dir    <DIR>
msh />

在终端输入 rmdir_example 命令，示例运行成功后可以通过命令 ls /data 查看删除成功。

msh />rmdir example
[I/example.rmdir] The deletion of the "example_dir" folder was successful.
msh />ls /data
Directory /data:
msh />