// 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:convert'; import 'dart:io'; import 'dart:typed_data'; import 'package:archive/archive.dart'; import 'package:flutter_devicelab/framework/apk_utils.dart'; import 'package:flutter_devicelab/framework/framework.dart'; import 'package:flutter_devicelab/framework/task_result.dart'; import 'package:flutter_devicelab/framework/utils.dart'; import 'package:path/path.dart' as path; final String gradlew = Platform.isWindows ? 'gradlew.bat' : 'gradlew'; final String gradlewExecutable = Platform.isWindows ? '.\\$gradlew' : './$gradlew'; final String fileReadWriteMode = Platform.isWindows ? 'rw-rw-rw-' : 'rw-r--r--'; /// Combines several TaskFunctions with trivial success value into one. TaskFunction combine(List tasks) { return () async { for (final task in tasks) { final TaskResult result = await task(); if (result.failed) { return result; } } return TaskResult.success(null); }; } /// Tests that the Flutter module project template works and supports /// adding Flutter to an existing Android app. class ModuleTest { ModuleTest({this.gradleVersion = '8.7'}); static const String buildTarget = 'module-gradle'; final String gradleVersion; final StringBuffer stdout = StringBuffer(); final StringBuffer stderr = StringBuffer(); Future call() async { section('Running: $buildTarget-$gradleVersion'); section('Find Java'); final String? javaHome = await findJavaHome(); if (javaHome == null) { return TaskResult.failure('Could not find Java'); } print('\nUsing JAVA_HOME=$javaHome'); section('Create Flutter module project'); final Directory tempDir = Directory.systemTemp.createTempSync('flutter_module_test.'); final projectDir = Directory(path.join(tempDir.path, 'hello')); try { await inDirectory(tempDir, () async { await flutter( 'create', options: ['--org', 'io.flutter.devicelab', '--template=module', 'hello'], output: stdout, stderr: stderr, ); }); section('Create package with native assets'); const ffiPackageName = 'ffi_package'; await createFfiPackage(ffiPackageName, tempDir); section('Add FFI package'); final pubspec = File(path.join(projectDir.path, 'pubspec.yaml')); String content = await pubspec.readAsString(); content = content.replaceFirst( 'dependencies:${Platform.lineTerminator}', 'dependencies:${Platform.lineTerminator} $ffiPackageName:${Platform.lineTerminator} path: ..${Platform.pathSeparator}$ffiPackageName${Platform.lineTerminator}', ); await pubspec.writeAsString(content, flush: true); await inDirectory(projectDir, () async { await flutter('packages', options: ['get'], output: stdout, stderr: stderr); }); section('Add read-only asset'); final File readonlyTxtAssetFile = await File( path.join(projectDir.path, 'assets', 'read-only.txt'), ).create(recursive: true); if (!exists(readonlyTxtAssetFile)) { return TaskResult.failure('Failed to create read-only asset'); } if (!Platform.isWindows) { await exec('chmod', ['444', readonlyTxtAssetFile.path]); } content = content.replaceFirst( '${Platform.lineTerminator} # assets:${Platform.lineTerminator}', '${Platform.lineTerminator} assets:${Platform.lineTerminator} - assets/read-only.txt${Platform.lineTerminator}', ); await pubspec.writeAsString(content, flush: true); section('Add plugins'); content = content.replaceFirst( '${Platform.lineTerminator}dependencies:${Platform.lineTerminator}', '${Platform.lineTerminator}dependencies:${Platform.lineTerminator}', ); await pubspec.writeAsString(content, flush: true); await inDirectory(projectDir, () async { await flutter('packages', options: ['get'], output: stdout, stderr: stderr); }); section('Build ephemeral host app'); await inDirectory(projectDir, () async { await flutter('build', options: ['apk'], output: stdout, stderr: stderr); }); final bool ephemeralHostApkBuilt = exists( File( path.join( projectDir.path, 'build', 'host', 'outputs', 'apk', 'release', 'app-release.apk', ), ), ); if (!ephemeralHostApkBuilt) { return TaskResult.failure('Failed to build ephemeral host .apk'); } section('Clean build'); await inDirectory(projectDir, () async { await flutter('clean', output: stdout, stderr: stderr); }); section('Build editable host app'); await inDirectory(projectDir, () async { await flutter('build', options: ['apk'], output: stdout, stderr: stderr); }); final bool editableHostApkBuilt = exists( File( path.join( projectDir.path, 'build', 'host', 'outputs', 'apk', 'release', 'app-release.apk', ), ), ); if (!editableHostApkBuilt) { return TaskResult.failure('Failed to build editable host .apk'); } section('Add to existing Android app'); final hostApp = Directory(path.join(tempDir.path, 'hello_host_app')); mkdir(hostApp); recursiveCopy( Directory( path.join( flutterDirectory.path, 'dev', 'integration_tests', 'pure_android_host_apps', 'host_app_kotlin_gradle_dsl', ), ), hostApp, ); copy(File(path.join(projectDir.path, '.android', gradlew)), hostApp); copy( File(path.join(projectDir.path, '.android', 'gradle', 'wrapper', 'gradle-wrapper.jar')), Directory(path.join(hostApp.path, 'gradle', 'wrapper')), ); // Modify gradle version to passed in version. // This is somehow the wrong file. final gradleWrapperProperties = File( path.join(hostApp.path, 'gradle', 'wrapper', 'gradle-wrapper.properties'), ); String propertyContent = await gradleWrapperProperties.readAsString(); propertyContent = propertyContent.replaceFirst('REPLACEME', gradleVersion); section(propertyContent); await gradleWrapperProperties.writeAsString(propertyContent, flush: true); section('Build debug host APK'); await inDirectory(hostApp, () async { if (!Platform.isWindows) { await exec('chmod', ['+x', 'gradlew']); } await exec( gradlewExecutable, ['app:assembleDebug'], environment: { 'JAVA_HOME': javaHome, 'FLUTTER_SUPPRESS_ANALYTICS': 'true', }, ); }); section('Check debug APK exists'); final String debugHostApk = path.join( hostApp.path, 'app', 'build', 'outputs', 'apk', 'debug', 'app-debug.apk', ); if (!exists(File(debugHostApk))) { return TaskResult.failure('Failed to build debug host APK'); } section('Check files in debug APK'); checkCollectionContains([ ...flutterAssets, ...debugAssets, ...baseApkFiles, 'lib/arm64-v8a/lib$ffiPackageName.so', 'lib/armeabi-v7a/lib$ffiPackageName.so', ], await getFilesInApk(debugHostApk)); section('Check debug AndroidManifest.xml'); final String androidManifestDebug = await getAndroidManifest(debugHostApk); if (!androidManifestDebug.contains(''' ''')) { return TaskResult.failure( "Debug host APK doesn't contain metadata: flutterProjectType = module ", ); } section('Check file access modes for read-only asset from Flutter module'); final String readonlyDebugAssetFilePath = path.joinAll([ hostApp.path, 'app', 'build', 'intermediates', 'assets', 'debug', 'mergeDebugAssets', 'flutter_assets', 'assets', 'read-only.txt', ]); final readonlyDebugAssetFile = File(readonlyDebugAssetFilePath); if (!exists(readonlyDebugAssetFile)) { return TaskResult.failure('Failed to copy read-only asset file'); } String modes = readonlyDebugAssetFile.statSync().modeString(); print('\nread-only.txt file access modes = $modes'); if (modes.compareTo(fileReadWriteMode) != 0) { return TaskResult.failure('Failed to make assets user-readable and writable'); } section('Build release host APK'); await inDirectory(hostApp, () async { await exec( gradlewExecutable, ['app:assembleRelease'], environment: { 'JAVA_HOME': javaHome, 'FLUTTER_SUPPRESS_ANALYTICS': 'true', }, ); }); final String releaseHostApk = path.join( hostApp.path, 'app', 'build', 'outputs', 'apk', 'release', 'app-release-unsigned.apk', ); if (!exists(File(releaseHostApk))) { return TaskResult.failure('Failed to build release host APK'); } section('Check files in release APK'); checkCollectionContains([ ...flutterAssets, ...baseApkFiles, 'lib/arm64-v8a/lib$ffiPackageName.so', 'lib/arm64-v8a/libapp.so', 'lib/arm64-v8a/libflutter.so', 'lib/armeabi-v7a/lib$ffiPackageName.so', 'lib/armeabi-v7a/libapp.so', 'lib/armeabi-v7a/libflutter.so', ], await getFilesInApk(releaseHostApk)); section('Check the NOTICE file is correct'); await inDirectory(hostApp, () async { final apkFile = File(releaseHostApk); final Archive apk = ZipDecoder().decodeBytes(apkFile.readAsBytesSync()); // Shouldn't be missing since we already checked it exists above. final ArchiveFile? noticesFile = apk.findFile('assets/flutter_assets/NOTICES.Z'); final licenseData = noticesFile?.content as Uint8List?; if (licenseData == null) { return TaskResult.failure('Invalid license file.'); } final String licenseString = utf8.decode(gzip.decode(licenseData)); if (!licenseString.contains('skia') || !licenseString.contains('Flutter Authors')) { return TaskResult.failure('License content missing.'); } }); section('Check release AndroidManifest.xml'); final String androidManifestRelease = await getAndroidManifest(debugHostApk); if (!androidManifestRelease.contains(''' ''')) { return TaskResult.failure( "Release host APK doesn't contain metadata: flutterProjectType = module ", ); } section('Check file access modes for read-only asset from Flutter module'); final String readonlyReleaseAssetFilePath = path.joinAll([ hostApp.path, 'app', 'build', 'intermediates', 'assets', 'release', 'mergeReleaseAssets', 'flutter_assets', 'assets', 'read-only.txt', ]); final readonlyReleaseAssetFile = File(readonlyReleaseAssetFilePath); if (!exists(readonlyReleaseAssetFile)) { return TaskResult.failure('Failed to copy read-only asset file'); } modes = readonlyReleaseAssetFile.statSync().modeString(); print('\nread-only.txt file access modes = $modes'); if (modes.compareTo(fileReadWriteMode) != 0) { return TaskResult.failure('Failed to make assets user-readable and writable'); } section('Check for specific log errors.'); final finalStderr = stderr.toString(); if (finalStderr.contains("You are applying Flutter's main Gradle plugin imperatively")) { return TaskResult.failure('Applied the Flutter Gradle Plugin imperatively'); } return TaskResult.success(null); } on TaskResult catch (taskResult) { return taskResult; } catch (e, stackTrace) { print('Task exception stack trace:\n$stackTrace'); return TaskResult.failure(e.toString()); } finally { rmTree(tempDir); } } } Future main() async { await task(combine([ModuleTest(gradleVersion: '8.14').call])); }