NativeScript-Vue iOS应用：替代nativescript-uuid的DeviceCheck API使用方案

Hey there! Since nativescript-uuid is no longer maintained, switching to Apple's DeviceCheck API is the right modern move for your iOS NativeScript-Vue app. Let's walk through the best ways to implement this—from the easiest plugin approach to a custom native bridge if you need more control:

1. Prerequisites First #

• Make sure your Apple Developer account has DeviceCheck enabled for your App ID (head to the Developer Portal, find your app's ID, and tick the DeviceCheck capability).
• Ensure your NativeScript project is on a recent version (v7+ recommended to avoid compatibility headaches).

2. Use a Community-Maintained Plugin (Simplest Option) #

Instead of writing native code from scratch, use a pre-built plugin that wraps the DeviceCheck API cleanly:

• Install the plugin via npm/yarn:

  npm install nativescript-device-check
  # Or with yarn:
  yarn add nativescript-device-check
  

• Implement it in your Vue component:
  Import the plugin and call its methods to get a device token, which you'll send to your backend for validation:

  import { DeviceCheck } from 'nativescript-device-check';
  
  async function fetchDeviceCheckToken() {
    try {
      // First, check if the device supports DeviceCheck
      const isSupported = await DeviceCheck.isSupported();
      if (!isSupported) {
        console.log("DeviceCheck isn't supported on this iOS device");
        return;
      }
  
      // Generate the base64-encoded token
      const deviceToken = await DeviceCheck.generateToken();
      console.log("DeviceCheck Token:", deviceToken);
  
      // Important: Send this token to your backend server
      // Your backend will use Apple's DeviceCheck API to validate it and assign a stable, persistent device ID for your app
    } catch (err) {
      console.error("Failed to get DeviceCheck token:", err);
    }
  }
  
  // Call this function when needed (e.g., on app launch or user login)
  fetchDeviceCheckToken();
  

  Heads up: The DeviceCheck token itself isn't a usable "UUID" directly. Apple requires you to validate it via your backend—your server will call Apple's QueryDeviceCheckToken endpoint to confirm the device's legitimacy, and you can then map that token to a custom, persistent ID in your database.

3. Build a Custom Native Bridge (If You Need Full Control) #

If you prefer to avoid community plugins and roll your own solution, here's how to bridge Swift's DeviceCheck code to your Vue app:

Step 1: Add iOS Native Code #

Create a DeviceCheckService.swift file in app/App_Resources/iOS/src/:

import Foundation
import DeviceCheck

@objc(DeviceCheckService)
class DeviceCheckService: NSObject {

  @objc func isDeviceCheckSupported() -> Bool {
    return DCDevice.current.isSupported
  }

  @objc func generateDeviceToken(completion: @escaping (String?, Error?) -> Void) {
    DCDevice.current.generateToken { tokenData, error in
      guard let data = tokenData, error == nil else {
        completion(nil, error)
        return
      }
      let base64Token = data.base64EncodedString()
      completion(base64Token, nil)
    }
  }
}

Step 2: Call the Native Service from Vue #

Use NativeScript's utility methods to access the Swift class in your Vue code:

import { ios } from '@nativescript/core/utils';

// Get a reference to our native service
const deviceCheckService = ios.getter(DeviceCheckService);

async function getCustomDeviceToken() {
  if (!deviceCheckService.isDeviceCheckSupported()) {
    console.log("DeviceCheck not supported on this device");
    return;
  }

  return new Promise((resolve, reject) => {
    deviceCheckService.generateDeviceToken((token, error) => {
      if (error) {
        reject(error);
      } else {
        resolve(token);
        // Send this token to your backend just like the plugin approach
      }
    });
  });
}

4. Critical Things to Remember #

• Don't treat the token as a UUID: The token is a temporary (well, device-unique but Apple-controlled) value—you must validate it via your backend to get a persistent identifier you can use.
• iOS Version Support: DeviceCheck works only on iOS 11.0+. Plan for fallback logic if you need to support older devices (though Apple's App Store now mostly requires iOS 15+, so this may be a non-issue).
• Privacy Compliance: Make sure your app's privacy policy clearly states that you use DeviceCheck, and that you're only using it for valid purposes (like fraud prevention or device-based personalization) as per Apple's guidelines.

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