FlutterDartVMServicePublisher.mm

Go to the documentation of this file.

// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
 
#define FML_USED_ON_EMBEDDER
 
#import "FlutterDartVMServicePublisher.h"
 
#if FLUTTER_RELEASE
 
@implementation FlutterDartVMServicePublisher
- (instancetype)initWithEnableVMServicePublication:(BOOL)enableVMServicePublication {
  return [super init];
}
@end
 
#else  // FLUTTER_RELEASE
 
#import <TargetConditionals.h>
// NSNetService works fine on physical devices before iOS 13.2.
// However, it doesn't expose the services to regular mDNS
// queries on the Simulator or on iOS 13.2+ devices.
//
// When debugging issues with this implementation, the following is helpful:
//
// 1) Running `dns-sd -Z _dartVmService`. This is a built-in macOS tool that
//    can find advertized observatories using this method. If dns-sd can't find
//    it, then the VM service is not getting advertised over any network
//    interface that the host machine has access to.
// 2) The Python zeroconf package. The dns-sd tool can sometimes see things
//    that aren't advertizing over a network interface - for example, simulators
//    using NSNetService has been observed using dns-sd, but doesn't show up in
//    the Python package (which is a high quality socket based implementation).
//    If that happens, this code should be tweaked such that it shows up in both
//    dns-sd's output and Python zeroconf's detection.
// 3) The Dart multicast_dns package, which is what Flutter uses to find the
//    port and auth code. If the advertizement shows up in dns-sd and Python
//    zeroconf but not multicast_dns, then it is a bug in multicast_dns.
#include <dns_sd.h>
#include <net/if.h>
 
#include "flutter/fml/logging.h"
#include "flutter/fml/message_loop.h"
#include "flutter/runtime/dart_service_isolate.h"
#import "flutter/shell/platform/darwin/common/InternalFlutterSwiftCommon/InternalFlutterSwiftCommon.h"
#import "flutter/shell/platform/darwin/common/framework/Headers/FlutterMacros.h"
 
FLUTTER_ASSERT_ARC
 
@protocol FlutterDartVMServicePublisherDelegate
- (void)publishServiceProtocolPort:(NSURL*)uri;
- (void)stopService;
@end
 
@interface FlutterDartVMServicePublisher ()
+ (NSData*)createTxtData:(NSURL*)url;
 
@property(readonly, class) NSString* serviceName;
@property(readonly) NSObject<FlutterDartVMServicePublisherDelegate>* delegate;
@property(nonatomic, readwrite) NSURL* url;
@property(readonly) BOOL enableVMServicePublication;
 
@end
 
@interface DartVMServiceDNSServiceDelegate : NSObject <FlutterDartVMServicePublisherDelegate>
@end
 
@implementation DartVMServiceDNSServiceDelegate {
  DNSServiceRef _dnsServiceRef;
}
 
- (void)stopService {
  if (_dnsServiceRef) {
    DNSServiceRefDeallocate(_dnsServiceRef);
    _dnsServiceRef = NULL;
  }
}
 
- (void)publishServiceProtocolPort:(NSURL*)url {
  DNSServiceFlags flags = kDNSServiceFlagsDefault;
#if TARGET_IPHONE_SIMULATOR
  // Simulator needs to use local loopback explicitly to work.
  uint32_t interfaceIndex = if_nametoindex("lo0");
#else   // TARGET_IPHONE_SIMULATOR
  // Physical devices need to request all interfaces.
  uint32_t interfaceIndex = 0;
#endif  // TARGET_IPHONE_SIMULATOR
  const char* registrationType = "_dartVmService._tcp";
 
  const char* domain = "local.";  // default domain
  uint16_t port = [[url port] unsignedShortValue];
 
  NSData* txtData = [FlutterDartVMServicePublisher createTxtData:url];
  int err = DNSServiceRegister(&_dnsServiceRef, flags, interfaceIndex,
                               FlutterDartVMServicePublisher.serviceName.UTF8String,
                               registrationType, domain, NULL, htons(port), txtData.length,
                               txtData.bytes, RegistrationCallback, NULL);
 
  if (err == 0) {
    DNSServiceSetDispatchQueue(_dnsServiceRef, dispatch_get_main_queue());
    return;
  }
 
  NSString* errorMessage = [NSString
      stringWithFormat:@"Failed to register Dart VM Service port with mDNS with error %d.", err];
  [FlutterLogger logError:errorMessage];
  if (@available(iOS 14.0, *)) {
    errorMessage = [NSString
        stringWithFormat:@"On iOS 14+, local network broadcast in apps need to be declared in "
                          "the app's Info.plist. Debug and profile Flutter apps and modules host "
                          "VM services on the local network to support debugging features such "
                          "as hot reload and DevTools. To make your Flutter app or module "
                          "attachable and debuggable, add a '%s' value to the 'NSBonjourServices' "
                          "key in your Info.plist for the Debug/Profile configurations. For more "
                          "information, see https://docs.flutter.cn/development/add-to-app/ios/"
                          "project-setup#local-network-privacy-permissions",
                         registrationType];
    [FlutterLogger logError:errorMessage];
  }
}
 
static void DNSSD_API RegistrationCallback(DNSServiceRef sdRef,
                                           DNSServiceFlags flags,
                                           DNSServiceErrorType errorCode,
                                           const char* name,
                                           const char* regType,
                                           const char* domain,
                                           void* context) {
  if (errorCode == kDNSServiceErr_NoError) {
    FML_DLOG(INFO) << "FlutterDartVMServicePublisher is ready!";
  } else if (errorCode == kDNSServiceErr_PolicyDenied) {
    // Local Network permissions on simulators stopped working in macOS 15.4 and will always return
    // kDNSServiceErr_PolicyDenied. See
    // https://github.com/flutter/flutter/issues/166333#issuecomment-2786720560.
#if TARGET_IPHONE_SIMULATOR
    FML_DLOG(WARNING)
        << "Could not register as server for FlutterDartVMServicePublisher, permission "
        << "denied. Check your 'Local Network' permissions for this app in the Privacy section of "
        << "the system Settings.";
#else   // TARGET_IPHONE_SIMULATOR
    [FlutterLogger logError:@"Could not register as server for FlutterDartVMServicePublisher, "
                             "permission denied. Check your 'Local Network' permissions for this "
                             "app in the Privacy section of the system Settings."];
#endif  // TARGET_IPHONE_SIMULATOR
  } else {
    [FlutterLogger logError:@"Could not register as server for FlutterDartVMServicePublisher. "
                             "Check your network settings and relaunch the application."];
  }
}
 
@end
 
@implementation FlutterDartVMServicePublisher {
  flutter::DartServiceIsolate::CallbackHandle _callbackHandle;
}
 
- (instancetype)initWithEnableVMServicePublication:(BOOL)enableVMServicePublication {
  self = [super init];
  NSAssert(self, @"Super must not return null on init.");
 
  _delegate = [[DartVMServiceDNSServiceDelegate alloc] init];
  _enableVMServicePublication = enableVMServicePublication;
  __weak __typeof(self) weakSelf = self;
 
  fml::MessageLoop::EnsureInitializedForCurrentThread();
 
  _callbackHandle = flutter::DartServiceIsolate::AddServerStatusCallback(
      [weakSelf, runner = fml::MessageLoop::GetCurrent().GetTaskRunner()](const std::string& uri) {
        if (!uri.empty()) {
          runner->PostTask([weakSelf, uri]() {
            FlutterDartVMServicePublisher* strongSelf = weakSelf;
            // uri comes in as something like 'http://127.0.0.1:XXXXX/' where XXXXX is the port
            // number.
            if (strongSelf) {
              NSURL* url =
                  [[NSURL alloc] initWithString:[NSString stringWithUTF8String:uri.c_str()]];
              strongSelf.url = url;
              if (strongSelf.enableVMServicePublication) {
                [[strongSelf delegate] publishServiceProtocolPort:url];
              }
            }
          });
        }
      });
 
  return self;
}
 
+ (NSString*)serviceName {
  return NSBundle.mainBundle.bundleIdentifier;
}
 
+ (NSData*)createTxtData:(NSURL*)url {
  // Check to see if there's an authentication code. If there is, we'll provide
  // it as a txt record so flutter tools can establish a connection.
  NSString* path = [[url path] substringFromIndex:MIN(1, [[url path] length])];
  NSData* pathData = [path dataUsingEncoding:NSUTF8StringEncoding];
  NSDictionary<NSString*, NSData*>* txtDict = @{
    @"authCode" : pathData,
  };
  return [NSNetService dataFromTXTRecordDictionary:txtDict];
}
 
- (void)dealloc {
  [_delegate stopService];
 
  flutter::DartServiceIsolate::RemoveServerStatusCallback(_callbackHandle);
}
@end
 
#endif  // FLUTTER_RELEASE