Nextcloud Server 插件开发实战60 分钟从零构建并发布你的第一个应用【免费下载链接】server☁️ Nextcloud server, a safe home for all your data项目地址: https://gitcode.com/GitHub_Trending/se/serverNextcloud Server 右上角的天气卡片并非内置功能而是 apps/ 目录里一个叫 weather_status 的插件。本文就以它为参照帮你在约 60 分钟内开发并发布自己的第一个 Nextcloud 插件——从目录骨架到别人能安装的 zip 包。插件在架构中的位置先建立地图你的插件和 files、comments 地位相同apps/ 下每个目录就是一个应用框架靠扫描其中的 appinfo/info.xml 加载它。插件与框架的交互只有三条通道① 路由——appinfo/routes.php 里的 HTTP 端点被分发到你的 Controller② 生命周期——lib/AppInfo/Application.php 里注册事件监听器和能力声明框架事件页面渲染、登录等就会派给你③ 前端——Vue 代码运行时通过 OCA.Dashboard 这类全局对象挂进已有界面容器。myapp/ ├── appinfo/ │ ├── info.xml # 元数据id、版本、兼容版本范围 │ └── routes.php # API 路由注册 ├── composer/ # 应用独立的 composer 自动加载 ├── lib/ │ ├── AppInfo/Application.php # 入口类 │ └── Controller/ # 请求处理 ├── src/ # Vue 前端源码 └── img/ # 应用图标最小可运行插件环境要求与目录骨架开发环境只需 PHP 8.3、Node.js 和 ComposerPHP 扩展清单就写在仓库根目录的 composer.json 里。克隆https://gitcode.com/GitHub_Trending/se/server后执行composer install和npm install一次环境就绪。最小可运行插件 apps/ 下一个新目录 info.xml 一个 Application 入口类。字段里最容易写错的是四个id小写、与目录同名、namespace大驼峰OCA\前缀的根源、version以及dependencies的 min/max-version——它决定应用能否出现在应用列表里。info ... idmyapp/id nameMy First App/name namespaceMyapp/namespace version1.0.0/version dependencies nextcloud min-version36 max-version36/ /dependencies /info仿照 apps/weather_status/lib/AppInfo/Application.php 写入口类extends App implements IBootstrap构造函数传入应用 id然后php occ app:enable myapp——应用出现在列表里空壳就跑起来了。前后端协作链路一次请求从地址到天气的完整闭环空壳之后下一个真实问题用户的操作落到哪里以 weather_status 的输入城市名看天气为例跟一次请求。前端通过全局对象挂进 Dashboard 容器Vue 应用经网络服务发出请求// src/weather-status.js把插件注入 Dashboard 容器 OCA.Dashboard.registerStatus(weather, (el) { const app createApp(App) return app.mount(el) })请求到服务端后第一站是 appinfo/routes.php。注意它把路由注册在ocs键下因此对应 Controller 必须继承 OCSControllerreturn [ ocs [ [name WeatherStatus#setLocation, url /api/v1/location, verb PUT], [name WeatherStatus#getForecast, url /api/v1/forecast, verb GET], ], ];WeatherStatus#setLocation即指向 WeatherStatus 控制器的 setLocation 方法。Controller 只收参数、返回 DataResponse业务在注入的 Service 里见 WeatherStatusController.php#[NoAdminRequired] // 允许普通用户调用 public function setLocation(?string $address, ?float $lat, ?float $lon): DataResponse { $weather $this-service-setLocation($address, $lat, $lon); return new DataResponse($weather); // 自动序列化为 JSON }Service 完成地址解析、拉取 6 小时预报并缓存坐标JSON 回到 src/App.vue 后按天气代码更新菜单文字与图标。操作 → 路由 → 服务端 → 渲染闭环完成所有插件都是这条链路的变体。工程化打磨图标、国际化与依赖声明上线前补齐三件小事。图标img/ 放app.svg与app-dark.svg深浅两套前端用imagePath(myapp, app.svg)引用应用列表自动生效。国际化用户可见文案一律t(myapp, Detect location)包裹第一参必须是应用 id再用php occ l10n:extract myapp生成 l10n/ 翻译骨架。依赖与事件PHP 扩展写在应用自带的 composer/ 目录参照 apps/weather_status/composer/composer.json监听器与能力在 Application.php 的register()注册——注册Capabilities后前端就能经 OCS capabilities 判断你的功能是否可用。验证与发布从本地 demo 到可分发的 zip验证三步走php occ app:enable myapp启用浏览器打开页面确认渲染用 curl 直接请求 API 核对 JSON——OCS 端点必须带OCS-APIRequest: true请求头漏了就是 404。全部通过后把应用目录压成 zip排除构建产物即安装产物别的服务器在应用页上传它或丢进 apps/ 后执行php occ app:update myapp。从我电脑能跑到别人能装跨的就是这两条命令。新手卡点与延伸入口⚠️ 三个高频坑①命名空间错位——OCA\前缀由 info.xml 的namespace拼出目录 weather_status 对应命名空间WeatherStatusPHP 文件声明差一个字母就是 class not found②版本范围不匹配——dependencies不覆盖当前服务器版本时应用列表直接空白报错信息几乎没有③routes 与 ocs 混用——routes键配普通 Controllerocs键配 OCSController错配即 404 且不抛异常。卡住时回到 apps/weather_status/lib/Service/WeatherStatusService.php 把完整链路读一遍——外部 API 怎么调、缓存怎么存、失败怎么兜底参考实现都在仓库里。【免费下载链接】server☁️ Nextcloud server, a safe home for all your data项目地址: https://gitcode.com/GitHub_Trending/se/server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Nextcloud Server 插件开发实战：60 分钟从零构建并发布你的第一个应用
Nextcloud Server 插件开发实战60 分钟从零构建并发布你的第一个应用【免费下载链接】server☁️ Nextcloud server, a safe home for all your data项目地址: https://gitcode.com/GitHub_Trending/se/serverNextcloud Server 右上角的天气卡片并非内置功能而是 apps/ 目录里一个叫 weather_status 的插件。本文就以它为参照帮你在约 60 分钟内开发并发布自己的第一个 Nextcloud 插件——从目录骨架到别人能安装的 zip 包。插件在架构中的位置先建立地图你的插件和 files、comments 地位相同apps/ 下每个目录就是一个应用框架靠扫描其中的 appinfo/info.xml 加载它。插件与框架的交互只有三条通道① 路由——appinfo/routes.php 里的 HTTP 端点被分发到你的 Controller② 生命周期——lib/AppInfo/Application.php 里注册事件监听器和能力声明框架事件页面渲染、登录等就会派给你③ 前端——Vue 代码运行时通过 OCA.Dashboard 这类全局对象挂进已有界面容器。myapp/ ├── appinfo/ │ ├── info.xml # 元数据id、版本、兼容版本范围 │ └── routes.php # API 路由注册 ├── composer/ # 应用独立的 composer 自动加载 ├── lib/ │ ├── AppInfo/Application.php # 入口类 │ └── Controller/ # 请求处理 ├── src/ # Vue 前端源码 └── img/ # 应用图标最小可运行插件环境要求与目录骨架开发环境只需 PHP 8.3、Node.js 和 ComposerPHP 扩展清单就写在仓库根目录的 composer.json 里。克隆https://gitcode.com/GitHub_Trending/se/server后执行composer install和npm install一次环境就绪。最小可运行插件 apps/ 下一个新目录 info.xml 一个 Application 入口类。字段里最容易写错的是四个id小写、与目录同名、namespace大驼峰OCA\前缀的根源、version以及dependencies的 min/max-version——它决定应用能否出现在应用列表里。info ... idmyapp/id nameMy First App/name namespaceMyapp/namespace version1.0.0/version dependencies nextcloud min-version36 max-version36/ /dependencies /info仿照 apps/weather_status/lib/AppInfo/Application.php 写入口类extends App implements IBootstrap构造函数传入应用 id然后php occ app:enable myapp——应用出现在列表里空壳就跑起来了。前后端协作链路一次请求从地址到天气的完整闭环空壳之后下一个真实问题用户的操作落到哪里以 weather_status 的输入城市名看天气为例跟一次请求。前端通过全局对象挂进 Dashboard 容器Vue 应用经网络服务发出请求// src/weather-status.js把插件注入 Dashboard 容器 OCA.Dashboard.registerStatus(weather, (el) { const app createApp(App) return app.mount(el) })请求到服务端后第一站是 appinfo/routes.php。注意它把路由注册在ocs键下因此对应 Controller 必须继承 OCSControllerreturn [ ocs [ [name WeatherStatus#setLocation, url /api/v1/location, verb PUT], [name WeatherStatus#getForecast, url /api/v1/forecast, verb GET], ], ];WeatherStatus#setLocation即指向 WeatherStatus 控制器的 setLocation 方法。Controller 只收参数、返回 DataResponse业务在注入的 Service 里见 WeatherStatusController.php#[NoAdminRequired] // 允许普通用户调用 public function setLocation(?string $address, ?float $lat, ?float $lon): DataResponse { $weather $this-service-setLocation($address, $lat, $lon); return new DataResponse($weather); // 自动序列化为 JSON }Service 完成地址解析、拉取 6 小时预报并缓存坐标JSON 回到 src/App.vue 后按天气代码更新菜单文字与图标。操作 → 路由 → 服务端 → 渲染闭环完成所有插件都是这条链路的变体。工程化打磨图标、国际化与依赖声明上线前补齐三件小事。图标img/ 放app.svg与app-dark.svg深浅两套前端用imagePath(myapp, app.svg)引用应用列表自动生效。国际化用户可见文案一律t(myapp, Detect location)包裹第一参必须是应用 id再用php occ l10n:extract myapp生成 l10n/ 翻译骨架。依赖与事件PHP 扩展写在应用自带的 composer/ 目录参照 apps/weather_status/composer/composer.json监听器与能力在 Application.php 的register()注册——注册Capabilities后前端就能经 OCS capabilities 判断你的功能是否可用。验证与发布从本地 demo 到可分发的 zip验证三步走php occ app:enable myapp启用浏览器打开页面确认渲染用 curl 直接请求 API 核对 JSON——OCS 端点必须带OCS-APIRequest: true请求头漏了就是 404。全部通过后把应用目录压成 zip排除构建产物即安装产物别的服务器在应用页上传它或丢进 apps/ 后执行php occ app:update myapp。从我电脑能跑到别人能装跨的就是这两条命令。新手卡点与延伸入口⚠️ 三个高频坑①命名空间错位——OCA\前缀由 info.xml 的namespace拼出目录 weather_status 对应命名空间WeatherStatusPHP 文件声明差一个字母就是 class not found②版本范围不匹配——dependencies不覆盖当前服务器版本时应用列表直接空白报错信息几乎没有③routes 与 ocs 混用——routes键配普通 Controllerocs键配 OCSController错配即 404 且不抛异常。卡住时回到 apps/weather_status/lib/Service/WeatherStatusService.php 把完整链路读一遍——外部 API 怎么调、缓存怎么存、失败怎么兜底参考实现都在仓库里。【免费下载链接】server☁️ Nextcloud server, a safe home for all your data项目地址: https://gitcode.com/GitHub_Trending/se/server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考