iOS设备使用cordova-plugin-vibration插件振动失效并崩溃问题求助

我之前做Cordova项目时也碰到过一模一样的iOS振动问题——Android上正常跑，一到iOS调用navigator.vibrate就直接崩，连弹窗都出不来。结合你的代码和iOS的特性，咱们一步步来修复：

1. 核心问题：未等待deviceready事件触发 #

Cordova的所有插件API（包括振动）都必须在deviceready事件触发后才能调用，iOS对这个要求比Android严格得多。如果提前调用，会直接触发未定义错误，导致代码中断（也就是你看到的弹窗不显示，因为navigator.vibrate那行已经崩了）。

你现在的代码直接绑定点击事件，完全没考虑deviceready，这是最可能的诱因。修改方式如下：

// 先等设备准备完成
document.addEventListener("deviceready", onDeviceReady, false);

function onDeviceReady() {
    // 设备就绪后再绑定点击事件
    document.querySelector('a[href="#"]').addEventListener('click', function(e) {
        e.preventDefault();
        vibrate();
    });
}

function vibrate() {
    try {
        var time = 3000;
        navigator.vibrate(time);
        alert('vibrate for 3 seconds');
    } catch (err) {
        // 捕获错误方便排查
        alert('振动出错：' + err.message);
    }
}

2. 添加iOS振动权限（iOS 13+必备） #

从iOS 13开始，系统要求APP必须声明振动权限才能使用振动功能，否则会被系统拦截甚至崩溃。你需要在config.xml中添加权限描述，Cordova会自动帮你写入Info.plist：

<platform name="ios">
    <config-file parent="NSVibrationUsageDescription" platform="ios" target="*-Info.plist">
        <string>需要振动权限来提供操作反馈</string>
    </config-file>
</platform>

3. 检查插件兼容性和版本 #

确保你安装的cordova-plugin-vibration是最新版本，且和当前cordova-ios版本兼容。可以重新安装插件试试：

cordova plugin remove cordova-plugin-vibration
cordova plugin add cordova-plugin-vibration

4. 测试iOS振动的特殊情况 #

iOS对振动时长有一定限制，虽然文档标注支持3000毫秒，但部分设备可能有上限。你可以先测试短时长（比如500毫秒）验证功能：

navigator.vibrate(500);

另外，iOS的静音开关会影响振动，如果设备处于静音模式，振动可能不会触发，这点也要注意测试。

按照上面的步骤修改后，应该就能解决iOS上的崩溃和振动失效问题了。

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