Armox
    Armox Academy 📚
    创建应用创建您的第一个应用

    创建你的第一个 App

    本指南将带你把一个 Canvas 工作流制作成 App。完成后,你会拥有一个任何人都能使用的可复用工具。

    前置条件(Prerequisites)

    在创建 App 之前,你需要:

    • ✅ 一个可用的 Canvas 工作流
    • ✅ 工作流已测试且输出质量满意
    • ✅ 清楚哪些输入应该允许用户修改

    Step 1:搭建工作流(Build Your Workflow)

    先创建并测试你的 Canvas 工作流。

    示例工作流

    我们做一个简单的产品图生成器:

    Prompt Template
    [Upload Node][BG Remover][Image Node (Flux Kontext)][Upscaler][Text Node: "on marble surface, studio lighting"]

    测试(Test It)

    1. 用示例输入运行工作流
    2. 检查输出质量
    3. 调整 settings 直到满意
    4. 保存 Canvas

    Step 2:打开 App Builder

    如何进入

    1. 打开你的 Canvas 工作流
    2. 在工具栏(或侧边栏)找到 App Builder 按钮
    3. 点击打开 App Builder 面板

    App Builder 面板包含什么

    你会看到:

    • App list — 这个 Canvas 已有的 Apps
    • Create New — 创建新 App 的按钮
    • Settings — 配置选项

    Step 3:为 App 命名

    App Name

    选择清晰、可描述的名字:

    Good names:

    • "Product Photo Generator"
    • "Social Media Post Creator"
    • "Video Ad Maker"

    Avoid:

    • "My App"
    • "Test"
    • "Workflow 1"

    Description

    写一段简短描述,说明 App 做什么:

    Generate professional product photos with custom backgrounds. 
    Upload your product image, describe the desired background, 
    and get a polished, high-resolution result.
    

    Step 4:配置 Inputs(最关键)

    这是最重要的一步:你要决定用户可以改工作流里的哪些部分。

    找到可用 Inputs

    App Builder 会列出所有可作为输入的节点/设置:

    • Text nodes(prompts)
    • Upload nodes(文件)
    • 可被修改的 settings

    选择要暴露的输入项(Expose)

    对每个要暴露的输入:

    1. Toggle it on — 让它对 App 用户可见
    2. Set the label — 用户看到的字段名(如 “Product Photo”)
    3. Set the type — Text / image / video / audio
    4. Mark as required — 是否必填

    示例配置

    对于产品图工作流:

    NodeExpose?LabelTypeRequired
    Upload Node✅ YesProduct PhotoImage✅ Yes
    Text Node (background)✅ YesBackground DescriptionText✅ Yes
    Upscaler settings❌ No

    Input Labels

    写清晰、对用户友好的字段名:

    Good labels:

    • "Product Photo"
    • "Background Description"
    • "Brand Name"

    Avoid:

    • "input_1"
    • "Text for node 3"
    • "Upload here"

    Step 5:添加缩略图(Thumbnail)

    缩略图能帮助用户快速识别 App。

    选项

    1. Upload an image — 上传你自己的缩略图
    2. Use from workflow — 用工作流生成的输出
    3. Select from assets — 从 Gallery 选择

    最佳实践

    • 选择工作流的真实输出作为缩略图
    • 让用户一眼知道 App 会生成什么
    • 画面尽量清晰
    • 方形或 4:3 比例通常最好

    Step 6:检查并保存

    保存前检查

    确认:

    • ✅ 名称清晰、可描述
    • ✅ 描述说明了 App 做什么
    • ✅ 暴露了所有必要 inputs
    • ✅ labels 对用户友好
    • ✅ 必填项标记正确
    • ✅ 缩略图能代表 App

    保存 App

    点击 SaveCreate App

    你的 App 现在可以使用了!


    Step 7:测试 App

    跑一次测试

    1. 进入 Apps 区域
    2. 找到你新创建的 App
    3. 填写 inputs
    4. 点击 Generate
    5. 检查输出

    检查体验

    问问自己:

    • 输入项是否足够清晰?
    • 输出是否符合预期?
    • 是否有让人困惑的地方?

    编辑 App

    进入编辑模式

    1. 进入 Apps 区域
    2. 找到 App
    3. 点击 EditSettings

    可以修改什么

    • App 名称与描述
    • 暴露哪些 inputs
    • inputs 的 labels 与必填项
    • Thumbnail

    不能修改什么

    • 底层工作流(请去 Canvas 修改)
    • 节点配置(请去 Canvas 修改)

    更新工作流

    如果需要改工作流:

    1. 打开原始 Canvas
    2. 修改
    3. 重新打开 App Builder
    4. 如有需要,更新 App 配置

    Best Practices

    保持简单

    • 只暴露必要输入
    • 不要用太多选项淹没用户
    • 复杂度留在幕后

    标签要清楚

    • 用普通语言
    • 写清楚需要什么
    • 有必要可加例子

    充分测试

    • 多跑几次
    • 尝试不同 inputs
    • 检查输出质量

    从用户视角思考

    • 谁会用这个 App?
    • 用户需要知道什么?
    • 哪些地方可能让人困惑?

    常见错误(Common Mistakes)

    ❌ 暴露太多 Inputs

    Problem: 用户会被大量选项淹没。
    Solution: 只暴露真正必要的输入,把高级设置隐藏起来。

    ❌ 标签不清楚

    Problem: 用户不知道该输入什么。
    Solution: 用描述性 labels,并补充 helpful descriptions。

    ❌ 不测试

    Problem: App 运行不符合预期。
    Solution: 分享前一定用多种输入测试。

    ❌ 忘记设置必填项

    Problem: 用户提交不完整 inputs。
    Solution: 把关键 inputs 标记为 required。


    示例:完整 App 配置

    Product Photo Generator

    Name: Product Photo Generator

    Description: Create professional product photos with custom backgrounds. Upload your product image and describe your ideal setting.

    Inputs:

    LabelTypeRequiredDescription
    Product PhotoImageYesUpload a clear photo of your product
    Background StyleTextYesDescribe the background (e.g., "white marble surface, soft studio lighting")

    Thumbnail: 产品放在大理石上的示例输出


    下一步