Skip to content

v1.0.1 — 修复插件在 Emby 4.9.0.x 上不显示 / fixes the plugin not appearing on Emby 4.9.0.x

Choose a tag to compare

View all tags
@cloud-fs cloud-fs released this 02 Aug 07:23
· 1 commit to main since this release
v1.0.1
1f30af0

修复版本：解决插件在部分 Emby 版本上不显示的问题。
Fix release: the plugin failed to appear in the plugin list on some Emby versions.

中文

本次修复

有用户反馈：把插件放进插件目录、重启 docker 之后，插件设置里看不到 CloudDrive。

原因：v1.0.0 是按 Emby SDK 4.9.1.90 编译的，程序集引用被固定在这个版本上。.NET 在解析引用时，只接受版本相同或更高的已加载程序集，不接受更低的。所以在 Emby 4.9.1 及以上一切正常（我们测试的环境都是），但在 Emby 4.9.0.x 上所有 MediaBrowser 引用都会解析失败，插件类型加载不出来，插件就从列表里消失了 —— 而服务器本身照常启动，所以除了"插件不见了"没有别的现象。

服务器日志里会看到：

ReflectionTypeLoadException: Unable to load one or more of the requested types.
Could not load file or assembly 'MediaBrowser.Common, Version=4.9.1.90' ...

v1.0.1 改为按 Emby 4.8 的 SDK（4.8.0.80）编译，引用固定在 4.8.0.80，于是 4.8.0.80 及以上的所有 Emby 都能正常加载。已实测：在 Emby 4.9.5.0 上插件正常出现在列表中，各接口工作正常。

功能没有任何改动，只是编译目标不同。

最低服务器版本

  • Emby 4.8.0.80 或更高（低于此版本会在日志里报 ReflectionTypeLoadException，插件不显示）
  • Jellyfin 10.11

升级方法

直接用新的 DLL 覆盖旧的，然后重启服务器即可。

⚠️ 在容器里替换 DLL 请重启容器，只按服务器自身的「重启」按钮不够。

English

What this fixes

A user reported that after dropping the plugin in and restarting docker, CloudDrive never appeared in the plugin settings.

v1.0.0 was compiled against Emby SDK 4.9.1.90, which pins the assembly references to exactly that version. .NET binds a reference to an already-loaded assembly only when the loaded version is equal or higher, never lower. So 4.9.1+ worked — which is everything we tested — but on Emby 4.9.0.x every MediaBrowser reference fails to resolve, no plugin types load, and the plugin quietly disappears from the list while the server boots normally.

The server log shows:

ReflectionTypeLoadException: Unable to load one or more of the requested types.
Could not load file or assembly 'MediaBrowser.Common, Version=4.9.1.90' ...

v1.0.1 is compiled against the Emby 4.8 SDK (4.8.0.80) instead, so the references satisfy every server from 4.8.0.80 upwards. Verified in both directions: the 4.8-compiled build lists correctly and answers all endpoints on a live Emby 4.9.5.0.

No functional changes — only the compile target.

Minimum server version

  • Emby 4.8.0.80 or newer (older logs a ReflectionTypeLoadException and the plugin never appears)
  • Jellyfin 10.11

Upgrading

Replace the DLL and restart the server.

⚠️ Replacing the DLL inside a container? Restart the container, not just the server.

Assets 4
Loading