@capacitor/status-bar在iOS端出现Unhandled Promise Rejection错误如何解决

Error: not implemented是Capacitor插件的标准报错，代表对应插件的原生层实现未在当前运行环境中正确注册，导入即触发报错说明iOS端插件未完成正确安装。

排查步骤 #

• 检查ios/App/Podfile文件中是否存在status-bar插件依赖条目
  正常配置下应包含pod 'CapacitorStatusBar', :path => '../../node_modules/@capacitor/status-bar'，不存在则说明项目同步步骤未执行成功
• 检查Xcode项目Pods组下是否存在CapacitorStatusBar文件夹
  缺失则说明Pod依赖安装失败
• 检查Xcode构建配置的Link Binary With Libraries列表
  确认列表中包含CapacitorStatusBar.framework，缺失则需要手动添加
• 确认运行环境
  status-bar仅支持原生iOS/Android环境，Web/浏览器环境无原生实现，在Safari调试Web页面时触发该报错属于预期行为

解决方案 #

标准修复流程 #

1. 执行插件同步命令，将插件配置同步到iOS项目：

npx cap sync ios

2. 进入iOS项目目录更新Pod依赖：

cd ios/App
pod install --repo-update

3. 清理Xcode缓存后重新编译
   打开Xcode后按Command + Shift + K清理构建缓存，再按Command + B重新构建项目即可

代码兼容优化 #

如果项目需要同时支持Web端运行，添加环境判断避免触发无效调用：

import { StatusBar, Style } from '@capacitor/status-bar';
import { Capacitor } from '@capacitor/core';

const hideStatusBar = async () => {
    if (Capacitor.isNativePlatform()) {
        await StatusBar.hide();
    }
};

异常场景修复 #

同步后仍不生效的情况下，重新安装插件再同步：

npm uninstall @capacitor/status-bar
npm install @capacitor/status-bar@1.0.3
npx cap sync ios
cd ios/App && pod install

完成后重新编译Xcode项目即可。

内容的提问来源于stack exchange，提问作者David