# 上传自定义应用

当您已经拥有构建好的 .oakapp 文件并希望将其发布到工作区的 Luxonis Hub 时，请使用本页面。

## 上传前

确保应用遵循 [OAK App 结构](https://docs.luxonis.com/software-v3/oak-apps.md)，并且已经打包成 .oakapp 文件。

如果您仍需构建应用工件，请先参考 [oakctl 指南](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)。

## 发布应用

### 认证 oakctl

使用您的 Luxonis Hub 工作区认证 oakctl。

```bash
oakctl hub login
```

### 发布构建好的 .oakapp 文件

发布构建好的应用工件。

```bash
oakctl hub publish <oakapp-file>
```

### 等待验证

等待上传和验证在 Luxonis Hub 中完成。

> **默认私有**
> 上传的应用仅对您的组织可见，除非您通过更广泛的分发途径显式发布它们。

## 验证结果

发布后，打开[团队应用页面](https://hub.luxonis.com/control/apps/team-apps)确认上传成功完成，并且应用在工作区中可用。

使用这些状态来了解上传是否已准备就绪或需要注意。

| 状态 | 含义 |
| --- | --- |
| `Completed` | 应用上传成功，现在可以在您的工作区中使用。 |
| `Rejected` | 上传未通过验证，例如缺少元数据、结构无效或格式不受支持。 |
| `Failed` | 由于服务器端或网络错误，上传未完成。 |

## 相关文档

### OAK Apps

了解 OAK 应用的结构和打包方式。

[OAK Apps](https://docs.luxonis.com/software-v3/oak-apps.md)

### oakctl

使用 Luxonis CLI 构建和发布应用工件。

[oakctl](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md)

### 管理应用

安装、启动、停止和检查发布后的应用。

[管理应用](https://docs.luxonis.com/cloud/features/application-management/manage-applications.md)

### 应用商店

查看已发布的应用在 Luxonis Hub 中的展示方式。

[应用商店](https://docs.luxonis.com/cloud/features/application-management/app-store.md)