// Copyright 2014 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. import 'dart:async'; import 'dart:convert'; import 'package:file/memory.dart'; import 'package:file_testing/file_testing.dart'; import 'package:flutter_tools/src/artifacts.dart'; import 'package:flutter_tools/src/base/file_system.dart'; import 'package:flutter_tools/src/base/logger.dart'; import 'package:flutter_tools/src/base/platform.dart'; import 'package:flutter_tools/src/cache.dart'; import 'package:flutter_tools/src/ios/ios_deploy.dart'; import 'package:flutter_tools/src/ios/iproxy.dart'; import '../../src/common.dart'; import '../../src/fake_process_manager.dart'; import '../../src/fakes.dart'; void main () { late Artifacts artifacts; late String iosDeployPath; late FileSystem fileSystem; setUp(() { artifacts = Artifacts.test(); iosDeployPath = artifacts.getHostArtifact(HostArtifact.iosDeploy).path; fileSystem = MemoryFileSystem.test(); }); testWithoutContext('IOSDeploy.iosDeployEnv returns path with /usr/bin first', () { final IOSDeploy iosDeploy = setUpIOSDeploy(FakeProcessManager.any()); final Map<String, String> environment = iosDeploy.iosDeployEnv; expect(environment['PATH'], startsWith('/usr/bin')); }); group('IOSDeploy.prepareDebuggerForLaunch', () { testWithoutContext('calls ios-deploy with correct arguments and returns when debugger attaches', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: <String>[ 'script', '-t', '0', '/dev/null', iosDeployPath, '--id', '123', '--bundle', '/', '--app_deltas', 'app-delta', '--uninstall', '--debug', '--args', <String>[ '--enable-dart-profiling', ].join(' '), ], environment: const <String, String>{ 'PATH': '/usr/bin:/usr/local/bin:/usr/bin', 'DYLD_LIBRARY_PATH': '/path/to/libraries', }, stdout: '(lldb) run\nsuccess\nDid finish launching.', ), ]); final Directory appDeltaDirectory = fileSystem.directory('app-delta'); final IOSDeploy iosDeploy = setUpIOSDeploy(processManager, artifacts: artifacts); final IOSDeployDebugger iosDeployDebugger = iosDeploy.prepareDebuggerForLaunch( deviceId: '123', bundlePath: '/', appDeltaDirectory: appDeltaDirectory, launchArguments: <String>['--enable-dart-profiling'], interfaceType: IOSDeviceConnectionInterface.network, uninstallFirst: true, ); expect(iosDeployDebugger.logLines, emits('Did finish launching.')); expect(await iosDeployDebugger.launchAndAttach(), isTrue); await iosDeployDebugger.logLines.drain(); expect(processManager, hasNoRemainingExpectations); expect(appDeltaDirectory, exists); }); }); group('IOSDeployDebugger', () { group('launch', () { late BufferLogger logger; setUp(() { logger = BufferLogger.test(); }); testWithoutContext('debugger attached and stopped', () async { final StreamController<List<int>> stdin = StreamController<List<int>>(); final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: const <String>['ios-deploy'], stdout: "(lldb) run\r\nsuccess\r\nsuccess\r\nLog on attach1\r\n\r\nLog on attach2\r\n\r\n\r\n\r\nPROCESS_STOPPED\r\nLog after process stop\r\nthread backtrace all\r\n* thread #1, queue = 'com.apple.main-thread', stop reason = signal SIGSTOP", stdin: IOSink(stdin.sink), ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); final List<String> receivedLogLines = <String>[]; final Stream<String> logLines = iosDeployDebugger.logLines ..listen(receivedLogLines.add); expect(iosDeployDebugger.logLines, emitsInOrder(<String>[ 'success', // ignore first "success" from lldb, but log subsequent ones from real logging. 'Log on attach1', 'Log on attach2', '', '', 'Log after process stop', ])); expect(stdin.stream.transform<String>(const Utf8Decoder()), emitsInOrder(<String>[ 'thread backtrace all', '\n', 'process detach', ])); expect(await iosDeployDebugger.launchAndAttach(), isTrue); await logLines.drain(); expect(logger.traceText, contains('PROCESS_STOPPED')); expect(logger.traceText, contains('thread backtrace all')); expect(logger.traceText, contains('* thread #1')); }); testWithoutContext('handle processing logging after process exit', () async { final StreamController<List<int>> stdin = StreamController<List<int>>(); // Make sure we don't hit a race where logging processed after the process exits // causes listeners to receive logging on the closed logLines stream. final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: const <String>['ios-deploy'], stdout: 'stdout: "(lldb) run\r\nsuccess\r\n', stdin: IOSink(stdin.sink), outputFollowsExit: true, ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); expect(iosDeployDebugger.logLines, emitsDone); expect(await iosDeployDebugger.launchAndAttach(), isFalse); await iosDeployDebugger.logLines.drain(); }); testWithoutContext('app exit', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ const FakeCommand( command: <String>['ios-deploy'], stdout: '(lldb) run\r\nsuccess\r\nLog on attach\r\nProcess 100 exited with status = 0\r\nLog after process exit', ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); expect(iosDeployDebugger.logLines, emitsInOrder(<String>[ 'Log on attach', 'Log after process exit', ])); expect(await iosDeployDebugger.launchAndAttach(), isTrue); await iosDeployDebugger.logLines.drain(); }); testWithoutContext('app crash', () async { final StreamController<List<int>> stdin = StreamController<List<int>>(); final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: const <String>['ios-deploy'], stdout: '(lldb) run\r\nsuccess\r\nLog on attach\r\n(lldb) Process 6156 stopped\r\n* thread #1, stop reason = Assertion failed:\r\nthread backtrace all\r\n* thread #1, stop reason = Assertion failed:', stdin: IOSink(stdin.sink), ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); expect(iosDeployDebugger.logLines, emitsInOrder(<String>[ 'Log on attach', '* thread #1, stop reason = Assertion failed:', ])); expect(stdin.stream.transform<String>(const Utf8Decoder()), emitsInOrder(<String>[ 'thread backtrace all', '\n', 'process detach', ])); expect(await iosDeployDebugger.launchAndAttach(), isTrue); await iosDeployDebugger.logLines.drain(); expect(logger.traceText, contains('Process 6156 stopped')); expect(logger.traceText, contains('thread backtrace all')); expect(logger.traceText, contains('* thread #1')); }); testWithoutContext('attach failed', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ const FakeCommand( command: <String>['ios-deploy'], // A success after an error should never happen, but test that we're handling random "successes" anyway. stdout: '(lldb) run\r\nerror: process launch failed\r\nsuccess\r\nLog on attach1', ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); // Debugger lines are double spaced, separated by an extra \r\n. Skip the extra lines. // Still include empty lines other than the extra added newlines. expect(iosDeployDebugger.logLines, emitsDone); expect(await iosDeployDebugger.launchAndAttach(), isFalse); await iosDeployDebugger.logLines.drain(); }); testWithoutContext('no provisioning profile 1, stdout', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ const FakeCommand( command: <String>['ios-deploy'], stdout: 'Error 0xe8008015', ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); await iosDeployDebugger.launchAndAttach(); expect(logger.errorText, contains('No Provisioning Profile was found')); }); testWithoutContext('no provisioning profile 2, stderr', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ const FakeCommand( command: <String>['ios-deploy'], stderr: 'Error 0xe8000067', ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); await iosDeployDebugger.launchAndAttach(); expect(logger.errorText, contains('No Provisioning Profile was found')); }); testWithoutContext('device locked', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ const FakeCommand( command: <String>['ios-deploy'], stdout: 'e80000e2', ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); await iosDeployDebugger.launchAndAttach(); expect(logger.errorText, contains('Your device is locked.')); }); testWithoutContext('unknown app launch error', () async { final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ const FakeCommand( command: <String>['ios-deploy'], stdout: 'Error 0xe8000022', ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); await iosDeployDebugger.launchAndAttach(); expect(logger.errorText, contains('Try launching from within Xcode')); }); }); testWithoutContext('detach', () async { final StreamController<List<int>> stdin = StreamController<List<int>>(); final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: const <String>[ 'ios-deploy', ], stdout: '(lldb) run\nsuccess', stdin: IOSink(stdin.sink), ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, ); expect(stdin.stream.transform<String>(const Utf8Decoder()), emits('process detach')); await iosDeployDebugger.launchAndAttach(); iosDeployDebugger.detach(); }); testWithoutContext('stop with backtrace', () async { final StreamController<List<int>> stdin = StreamController<List<int>>(); final Stream<String> stdinStream = stdin.stream.transform<String>(const Utf8Decoder()); final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: const <String>[ 'ios-deploy', ], stdout: '(lldb) run\nsuccess\nLog on attach\n(lldb) Process 6156 stopped\n* thread #1, stop reason = Assertion failed:\n(lldb) Process 6156 detached', stdin: IOSink(stdin.sink), ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, ); await iosDeployDebugger.launchAndAttach(); await iosDeployDebugger.stopAndDumpBacktrace(); expect(await stdinStream.take(3).toList(), <String>[ 'thread backtrace all', '\n', 'process detach', ]); }); testWithoutContext('pause with backtrace', () async { final StreamController<List<int>> stdin = StreamController<List<int>>(); final Stream<String> stdinStream = stdin.stream.transform<String>(const Utf8Decoder()); const String stdout = ''' (lldb) run success Log on attach (lldb) Process 6156 stopped * thread #1, stop reason = Assertion failed: thread backtrace all process continue * thread #1, stop reason = signal SIGSTOP * frame #0: 0x0000000102eaee80 dyld`dyld3::MachOFile::read_uleb128(Diagnostics&, unsigned char const*&, unsigned char const*) + 36 frame #1: 0x0000000102eabbd4 dyld`dyld3::MachOLoaded::trieWalk(Diagnostics&, unsigned char const*, unsigned char const*, char const*) + 332 frame #2: 0x0000000102eaa078 dyld`DyldSharedCache::hasImagePath(char const*, unsigned int&) const + 144 frame #3: 0x0000000102eaa13c dyld`DyldSharedCache::hasNonOverridablePath(char const*) const + 44 frame #4: 0x0000000102ebc404 dyld`dyld3::closure::ClosureBuilder::findImage(char const*, dyld3::closure::ClosureBuilder::LoadedImageChain const&, dyld3::closure::ClosureBuilder::BuilderLoadedImage*&, dyld3::closure::ClosureBuilder::LinkageType, unsigned int, bool) + frame #5: 0x0000000102ebd974 dyld`invocation function for block in dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 136 frame #6: 0x0000000102eae1b0 dyld`invocation function for block in dyld3::MachOFile::forEachDependentDylib(void (char const*, bool, bool, bool, unsigned int, unsigned int, bool&) block_pointer) const + 136 frame #7: 0x0000000102eadc38 dyld`dyld3::MachOFile::forEachLoadCommand(Diagnostics&, void (load_command const*, bool&) block_pointer) const + 168 frame #8: 0x0000000102eae108 dyld`dyld3::MachOFile::forEachDependentDylib(void (char const*, bool, bool, bool, unsigned int, unsigned int, bool&) block_pointer) const + 116 frame #9: 0x0000000102ebd80c dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 164 frame #10: 0x0000000102ebd8a8 dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 320 frame #11: 0x0000000102ebd8a8 dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 320 frame #12: 0x0000000102ebd8a8 dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 320 frame #13: 0x0000000102ebd8a8 dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 320 frame #14: 0x0000000102ebd8a8 dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 320 frame #15: 0x0000000102ebd8a8 dyld`dyld3::closure::ClosureBuilder::recursiveLoadDependents(dyld3::closure::ClosureBuilder::LoadedImageChain&, bool) + 320 frame #16: 0x0000000102ec7638 dyld`dyld3::closure::ClosureBuilder::makeLaunchClosure(dyld3::closure::LoadedFileInfo const&, bool) + 752 frame #17: 0x0000000102e8fcf0 dyld`dyld::buildLaunchClosure(unsigned char const*, dyld3::closure::LoadedFileInfo const&, char const**) + 344 frame #18: 0x0000000102e8e938 dyld`dyld::_main(macho_header const*, unsigned long, int, char const**, char const**, char const**, unsigned long*) + 2876 frame #19: 0x0000000102e8922c dyld`dyldbootstrap::start(dyld3::MachOLoaded const*, int, char const**, dyld3::MachOLoaded const*, unsigned long*) + 432 frame #20: 0x0000000102e89038 dyld`_dyld_start + 56 '''; final BufferLogger logger = BufferLogger.test(); final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand( command: const <String>[ 'ios-deploy', ], stdout: stdout, stdin: IOSink(stdin.sink), ), ]); final IOSDeployDebugger iosDeployDebugger = IOSDeployDebugger.test( processManager: processManager, logger: logger, ); await iosDeployDebugger.launchAndAttach(); await iosDeployDebugger.pauseDumpBacktraceResume(); // verify stacktrace was logged to trace expect( logger.traceText, contains( 'frame #0: 0x0000000102eaee80 dyld`dyld3::MachOFile::read_uleb128(Diagnostics&, unsigned char const*&, unsigned char const*) + 36', ), ); expect(await stdinStream.take(3).toList(), <String>[ 'thread backtrace all', '\n', 'process detach', ]); }); }); group('IOSDeploy.uninstallApp', () { testWithoutContext('calls ios-deploy with correct arguments and returns 0 on success', () async { const String deviceId = '123'; const String bundleId = 'com.example.app'; final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand(command: <String>[ iosDeployPath, '--id', deviceId, '--uninstall_only', '--bundle_id', bundleId, ]), ]); final IOSDeploy iosDeploy = setUpIOSDeploy(processManager, artifacts: artifacts); final int exitCode = await iosDeploy.uninstallApp( deviceId: deviceId, bundleId: bundleId, ); expect(exitCode, 0); expect(processManager, hasNoRemainingExpectations); }); testWithoutContext('returns non-zero exit code when ios-deploy does the same', () async { const String deviceId = '123'; const String bundleId = 'com.example.app'; final FakeProcessManager processManager = FakeProcessManager.list(<FakeCommand>[ FakeCommand(command: <String>[ iosDeployPath, '--id', deviceId, '--uninstall_only', '--bundle_id', bundleId, ], exitCode: 1), ]); final IOSDeploy iosDeploy = setUpIOSDeploy(processManager, artifacts: artifacts); final int exitCode = await iosDeploy.uninstallApp( deviceId: deviceId, bundleId: bundleId, ); expect(exitCode, 1); expect(processManager, hasNoRemainingExpectations); }); }); } IOSDeploy setUpIOSDeploy(ProcessManager processManager, { Artifacts? artifacts, }) { final FakePlatform macPlatform = FakePlatform( operatingSystem: 'macos', environment: <String, String>{ 'PATH': '/usr/local/bin:/usr/bin', } ); final Cache cache = Cache.test( platform: macPlatform, artifacts: <ArtifactSet>[ FakeDyldEnvironmentArtifact(), ], processManager: FakeProcessManager.any(), ); return IOSDeploy( logger: BufferLogger.test(), platform: macPlatform, processManager: processManager, artifacts: artifacts ?? Artifacts.test(), cache: cache, ); }