test/jdk/tools/jpackage/share/AppContentTest.java - master - githubmirror/panama-vector

test/jdk/tools/jpackage/share/AppContentTest.java
790 строк30 KB
Alexey Semenyuk
8374839: Improve jpackage information messages
05 май 2026, 00:00
05 май 2026, 00:0006e6539
/*
 * Copyright (c) 2020, 2026, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

import static java.util.Map.entry;
import static java.util.stream.Collectors.joining;
import static java.util.stream.Collectors.toMap;
import static jdk.internal.util.OperatingSystem.MACOS;
import static jdk.internal.util.OperatingSystem.WINDOWS;
import static jdk.jpackage.internal.util.function.ThrowingFunction.toFunction;

import java.io.IOException;
import java.io.UncheckedIOException;
import java.nio.file.Files;
import java.nio.file.NoSuchFileException;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashSet;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.Set;
import java.util.TreeMap;
import java.util.function.Function;
import java.util.function.Predicate;
import java.util.function.Supplier;
import java.util.regex.Pattern;
import java.util.stream.Stream;
import java.util.stream.StreamSupport;
import jdk.jpackage.internal.util.FileUtils;
import jdk.jpackage.internal.util.IdentityWrapper;
import jdk.jpackage.internal.util.function.ThrowingSupplier;
import jdk.jpackage.test.Annotations.Parameter;
import jdk.jpackage.test.Annotations.ParameterSupplier;
import jdk.jpackage.test.Annotations.Test;
import jdk.jpackage.test.CannedFormattedString;
import jdk.jpackage.test.ConfigurationTarget;
import jdk.jpackage.test.FailedCommandErrorValidator;
import jdk.jpackage.test.JPackageCommand;
import jdk.jpackage.test.JPackageCommand.MessageCategory;
import jdk.jpackage.test.JPackageOutputValidator;
import jdk.jpackage.test.JPackageStringBundle;
import jdk.jpackage.test.PackageTest;
import jdk.jpackage.test.PackageType;
import jdk.jpackage.test.TKit;


/**
 * Tests generation of packages with additional content in app image.
 */

/*
 * @test
 * @summary jpackage with --app-content option
 * @library /test/jdk/tools/jpackage/helpers
 * @key jpackagePlatformPackage
 * @build jdk.jpackage.test.*
 * @build AppContentTest
 * @run main/othervm/timeout=720 -Xmx512m jdk.jpackage.test.Main
 *  --jpt-run=AppContentTest
 */
public class AppContentTest {

    @Test
    @ParameterSupplier
    @ParameterSupplier(value="testSymlink", ifNotOS = WINDOWS)
    public void test(TestSpec testSpec) throws Exception {
        testSpec.test(new ConfigurationTarget(new PackageTest().configureHelloApp()));
    }

    @Test
    @ParameterSupplier("test")
    @ParameterSupplier(value="testSymlink", ifNotOS = WINDOWS)
    @ParameterSupplier
    public void testAppImage(TestSpec testSpec) throws Exception {
        testSpec.test(new ConfigurationTarget(JPackageCommand.helloAppImage()));
    }

    @Test(ifOS = MACOS)
    @Parameter("NOT_DIRECTORY")
    @Parameter("NON_STANDARD_DIRECTORY_NAME")
    public void testWarnings(AppContentMultiLineWarning type) throws Exception {

        var cmd = JPackageCommand.helloAppImage()
                .setFakeRuntime()
                .saveConsoleOutput(true)
                .setEnabledMessageCategories(MessageCategory.WARNINGS, MessageCategory.ERRORS);
        for (var appContent: type.initAppContent()) {
            cmd.addArguments("--app-content", appContent);
        }

        var result = cmd.executeIgnoreExitCode();

        var validator = new JPackageOutputValidator().stderr();

        validator.expectMatchingStrings(JPackageCommand.makeSummaryMultiLineWarning("warning.non-standard-app-content"));
        type.expectedWarnings().stream().map(str -> {
            return TKit.assertTextStream("  " + str.getValue()).predicate(String::equals);
        }).forEach(validator::add);

        // Signing is finicky when the bundle contains invalid content.
        // It may pass or fail depending on the version of the codesign (macOS version?).
        if (result.getExitCode() != 0) {
            // Expect codesign error in the output.
            var cmdlinePattern = String.format(
                    "^/usr/bin/codesign -s - -vvvv --force %s",
                    Pattern.quote(cmd.outputBundle().normalize().toAbsolutePath().toString()));

            //
            // Typical codesign error:
            //
            // foo/output/WarningsAppContentTest.app: replacing existing signature
            // foo/output/WarningsAppContentTest.app: code object is not signed at all
            // In subcomponent: foo/output/WarningsAppContentTest.app/Contents/dukeplug.png
            //

            var errorValidator = new FailedCommandErrorValidator(Pattern.compile(cmdlinePattern))
                    .exitCode(1)
                    .validators(
                            TKit.assertTextStream(": replacing existing signature").predicate(String::endsWith),
                            TKit.assertTextStream(": code object is not signed at all").predicate(String::endsWith),
                            TKit.assertTextStream("In subcomponent: ").predicate(String::startsWith))
                    .create();
            validator.add(errorValidator);
        }

        validator.validateEndOfStream().applyTo(cmd, result);
    }

    public enum AppContentMultiLineWarning {
        NOT_DIRECTORY("warning.non-standard-app-content.not-dir", Path.of("apps/dukeplug.png")),
        NON_STANDARD_DIRECTORY_NAME("warning.non-standard-app-content.non-standard-dir-name", Path.of("apps")),
        ;

        AppContentMultiLineWarning(String formatKey, Path appContent) {
            this.formatKey = Objects.requireNonNull(formatKey);
            this.appContent = TKit.TEST_SRC_ROOT.resolve(appContent);
        }

        List<Path> initAppContent() {
            return List.of(appContent);
        }

        List<CannedFormattedString> expectedWarnings() {
            return switch (this) {
                case NOT_DIRECTORY -> {
                    yield List.of(JPackageStringBundle.MAIN.cannedFormattedString(formatKey, appContent));
                }
                case NON_STANDARD_DIRECTORY_NAME -> {
                    yield List.of(JPackageStringBundle.MAIN.cannedFormattedString(formatKey, appContent.getFileName(), appContent));
                }
            };
        }

        private final String formatKey;
        private Path appContent;
    }

    public static Collection<Object[]> test() {
        return Stream.of(
                build().add(TEST_JAVA).add(TEST_DUKE),
                build().add(TEST_JAVA).add(TEST_BAD),
                build().startGroup().add(TEST_JAVA).add(TEST_DUKE).endGroup().add(TEST_DIR),
                // Same directory specified multiple times.
                build().add(TEST_DIR).add(TEST_DIR),
                // Same file specified multiple times.
                build().add(TEST_JAVA).add(TEST_JAVA),
                // Two files with the same name but different content.
                build()
                        .add(createTextFileContent("welcome.txt", "Welcome"))
                        .add(createTextFileContent("welcome.txt", "Benvenuti")),
                // Same name: one is a directory, another is a file.
                build().add(createTextFileContent("a/b/c/d", "Foo")).add(createTextFileContent("a", "Bar")),
                // Same name: one is a file, another is a directory.
                build().add(createTextFileContent("a", "Bar")).add(createTextFileContent("a/b/c/d", "Foo"))
        ).map(TestSpec.Builder::create).map(v -> {
            return new Object[] {v};
        }).toList();
    }

    public static Collection<Object[]> testAppImage() {
        return Stream.of(
                build().add(NonExistentPath.create("*output-app-image*", JPackageCommand::outputBundle))
        ).map(TestSpec.Builder::create).map(v -> {
            return new Object[] {v};
        }).toList();
    }

    public static Collection<Object[]> testSymlink() {
        return Stream.of(
                build().add(TEST_JAVA)
                        .add(new SymlinkContentFactory("Links", "duke-link", "duke-target"))
                        .add(new SymlinkContentFactory("", "a/b/foo-link", "c/bar-target"))
        ).map(TestSpec.Builder::create).map(v -> {
            return new Object[] {v};
        }).toList();
    }

    public record TestSpec(List<List<ContentFactory>> contentFactories) {
        public TestSpec {
            contentFactories.stream().flatMap(List::stream).forEach(Objects::requireNonNull);
        }

        @Override
        public String toString() {
            return contentFactories.stream().map(group -> {
                return group.stream().map(ContentFactory::toString).collect(joining(","));
            }).collect(joining("; "));
        }

        void test(ConfigurationTarget target) {
            final int expectedJPackageExitCode;
            if (contentFactories.stream().flatMap(List::stream).anyMatch(NonExistentPath.class::isInstance)) {
                expectedJPackageExitCode = 1;
            } else {
                expectedJPackageExitCode = 0;
            }

            final List<List<Content>> allContent = new ArrayList<>();

            target.addInitializer(JPackageCommand::setFakeRuntime)
            .addInitializer(cmd -> {
                contentFactories.stream().map(group -> {
                    return group.stream().map(contentFactory -> {
                        return contentFactory.create(cmd);
                    }).toList();
                }).forEach(allContent::add);
            }).addInitializer(cmd -> {
                allContent.stream().map(group -> {
                    return Stream.of("--app-content", group.stream()
                            .map(Content::paths)
                            .flatMap(List::stream)
                            .map(appContentArg -> {
                                if (COPY_IN_RESOURCES && Optional.ofNullable(appContentArg.getParent())
                                        .map(Path::getFileName)
                                        .map(RESOURCES_DIR::equals)
                                        .orElse(false)) {
                                    return appContentArg.getParent();
                                } else {
                                    return appContentArg;
                                }
                            })
                            .map(Path::toString)
                            .collect(joining(",")));
                    }).flatMap(x -> x).forEachOrdered(cmd::addArgument);
            });

            target.cmd().ifPresent(cmd -> {
                if (expectedJPackageExitCode == 0) {
                    cmd.executeAndAssertImageCreated();
                } else {
                    cmd.execute(expectedJPackageExitCode);
                }
            });

            target.addInstallVerifier(cmd -> {
                if (expectedJPackageExitCode != 0) {
                    return;
                }

                var appContentRoot = getAppContentRoot(cmd);

                Set<PathVerifier> disabledVerifiers = new HashSet<>();

                var verifiers = allContent.stream().flatMap(List::stream).flatMap(content -> {
                    return StreamSupport.stream(content.verifiers(appContentRoot).spliterator(), false).map(verifier -> {
                        return new PathVerifierWithOrigin(verifier, content);
                    });
                }).collect(toMap(PathVerifierWithOrigin::path, x -> x, (first, second) -> {
                    // The same file in the content directory is sourced from multiple origins.
                    // jpackage will handle this case such that the following origins overwrite preceding origins.
                    // Scratch all path verifiers affected by overrides.
                    first.getNestedVerifiers(appContentRoot, first.path()).forEach(disabledVerifiers::add);
                    return second;
                }, TreeMap::new)).values().stream()
                        .map(PathVerifierWithOrigin::verifier)
                        .filter(Predicate.not(disabledVerifiers::contains))
                        .filter(verifier -> {
                            if (!(verifier instanceof DirectoryVerifier dirVerifier)) {
                                return true;
                            } else {
                                try {
                                    // Run the directory verifier if the directory is empty.
                                    // Otherwise, it just pollutes the test log.
                                    return isDirectoryEmpty(verifier.path());
                                } catch (NoSuchFileException ex) {
                                    // If an MSI contains an empty directory, it will be installed but not created when the MSI is unpacked.
                                    // In the latter the control flow will reach this point.
                                    if (dirVerifier.isEmpty()
                                            && PackageType.WINDOWS.contains(cmd.packageType())
                                            && cmd.isPackageUnpacked(String.format(
                                                    "Expected empty directory [%s] is missing", verifier.path()))) {
                                        return false;
                                    }
                                    throw new UncheckedIOException(ex);
                                } catch (IOException ex) {
                                    throw new UncheckedIOException(ex);
                                }
                            }
                        })
                        .toList();

                verifiers.forEach(PathVerifier::verify);
            });

            target.test().ifPresent(test -> {
                test.setExpectedExitCode(expectedJPackageExitCode).run();
            });
        }

        static final class Builder {
            TestSpec create() {
                return new TestSpec(groups);
            }

            final class GroupBuilder {
                GroupBuilder add(ContentFactory cf) {
                    group.add(Objects.requireNonNull(cf));
                    return this;
                }

                Builder endGroup() {
                    if (!group.isEmpty()) {
                        groups.add(group);
                    }
                    return Builder.this;
                }

                private final List<ContentFactory> group = new ArrayList<>();
            }

            Builder add(ContentFactory cf) {
                return startGroup().add(cf).endGroup();
            }

            GroupBuilder startGroup() {
                return new GroupBuilder();
            }

            private final List<List<ContentFactory>> groups = new ArrayList<>();
        }

        private record PathVerifierWithOrigin(PathVerifier verifier, Content origin) {
            PathVerifierWithOrigin {
                Objects.requireNonNull(verifier);
                Objects.requireNonNull(origin);
            }

            Path path() {
                return verifier.path();
            }

            Stream<PathVerifier> getNestedVerifiers(Path appContentRoot, Path path) {
                if (!path.startsWith(appContentRoot)) {
                    throw new IllegalArgumentException();
                }

                return StreamSupport.stream(origin.verifiers(appContentRoot).spliterator(), false).filter(v -> {
                    return v.path().getNameCount() > path.getNameCount() && v.path().startsWith(path);
                });
            }
        }
    }

    private static TestSpec.Builder build() {
        return new TestSpec.Builder();
    }

    private static Path getAppContentRoot(JPackageCommand cmd) {
        final Path contentDir = cmd.appLayout().contentDirectory();
        if (COPY_IN_RESOURCES) {
            return contentDir.resolve(RESOURCES_DIR);
        } else {
            return contentDir;
        }
    }

    private static Path createAppContentRoot() {
        if (COPY_IN_RESOURCES) {
            return TKit.createTempDirectory("app-content").resolve(RESOURCES_DIR);
        } else {
            return TKit.createTempDirectory("app-content");
        }
    }

    private static boolean isDirectoryEmpty(Path path) throws IOException {
        if (Files.exists(path) && !Files.isDirectory(path)) {
            throw new IllegalArgumentException();
        }

        try (var files = Files.list(path)) {
            return files.findAny().isEmpty();
        }
    }

    @FunctionalInterface
    private interface ContentFactory {
        Content create(JPackageCommand cmd);
    }

    private interface Content {
        List<Path> paths();
        Iterable<PathVerifier> verifiers(Path appContentRoot);
    }

    private sealed interface PathVerifier {
        Path path();
        void verify();
    }

    private record RegularFileVerifier(Path path, Path srcFile) implements PathVerifier {
        RegularFileVerifier {
            Objects.requireNonNull(path);
            Objects.requireNonNull(srcFile);
        }

        @Override
        public void verify() {
            TKit.assertSameFileContent(srcFile, path);
        }
    }

    private record DirectoryVerifier(Path path, boolean isEmpty, IdentityWrapper<Content> origin) implements PathVerifier {
        DirectoryVerifier {
            Objects.requireNonNull(path);
        }

        @Override
        public void verify() {
            if (isEmpty) {
                TKit.assertDirectoryEmpty(path);
            } else {
                TKit.assertDirectoryExists(path);
            }
        }
    }

    private record SymlinkTargetVerifier(Path path, Path targetPath) implements PathVerifier {
        SymlinkTargetVerifier {
            Objects.requireNonNull(path);
            Objects.requireNonNull(targetPath);
        }

        @Override
        public void verify() {
            TKit.assertSymbolicLinkTarget(path, targetPath);
        }
    }

    private record NoPathVerifier(Path path) implements PathVerifier {
        NoPathVerifier {
            Objects.requireNonNull(path);
        }

        @Override
        public void verify() {
            TKit.assertPathExists(path, false);
        }
    }

    private record FileContent(Path path, int level) implements Content {

        FileContent {
            Objects.requireNonNull(path);
            if ((level < 0) || (path.getNameCount() <= level)) {
                throw new IllegalArgumentException();
            }
        }

        @Override
        public List<Path> paths() {
            return List.of(appContentOptionValue());
        }

        @Override
        public Iterable<PathVerifier> verifiers(Path appContentRoot) {
            List<PathVerifier> verifiers = new ArrayList<>();

            var appContentPath = appContentRoot.resolve(pathInAppContentRoot());

            if (Files.isDirectory(path)) {
                try (var walk = Files.walk(path)) {
                    verifiers.addAll(walk.map(srcFile -> {
                        var dstFile = appContentPath.resolve(path.relativize(srcFile));
                        if (Files.isRegularFile(srcFile)) {
                            return new RegularFileVerifier(dstFile, srcFile);
                        } else {
                            return new DirectoryVerifier(dstFile,
                                    toFunction(AppContentTest::isDirectoryEmpty).apply(srcFile),
                                    new IdentityWrapper<>(this));
                        }
                    }).toList());
                } catch (IOException ex) {
                    throw new UncheckedIOException(ex);
                }
            } else if (Files.isRegularFile(path)) {
                verifiers.add(new RegularFileVerifier(appContentPath, path));
            } else {
                verifiers.add(new NoPathVerifier(appContentPath));
            }

            if (level > 0) {
                var cur = appContentPath;
                for (int i = 0; i != level; i++) {
                    cur = cur.getParent();
                    verifiers.add(new DirectoryVerifier(cur, false, new IdentityWrapper<>(this)));
                }
            }

            return verifiers;
        }

        private Path appContentOptionValue() {
            var cur = path;
            for (int i = 0; i != level; i++) {
                cur = cur.getParent();
            }
            return cur;
        }

        private Path pathInAppContentRoot() {
            return StreamSupport.stream(path.spliterator(), false)
                    .skip(path.getNameCount() - level - 1)
                    .reduce(Path::resolve).orElseThrow();
        }
    }

    /**
     * Non-existing content.
     */
    private static final class NonExistentPath implements ContentFactory {

        private NonExistentPath(String label, Function<JPackageCommand, Path> makePath) {
            this.label = Objects.requireNonNull(label);
            this.makePath = Objects.requireNonNull(makePath);
        }

        @Override
        public Content create(JPackageCommand cmd) {
            var nonexistent = makePath.apply(cmd);
            if (Files.exists(nonexistent)) {
                throw new IllegalStateException();
            }
            return new FileContent(nonexistent, 0);
        }

        @Override
        public String toString() {
            return label;
        }

        static NonExistentPath create(String label, Function<JPackageCommand, Path> makePath) {
            return new NonExistentPath(label, makePath);
        }

        static NonExistentPath create(String path) {
            return new NonExistentPath(String.format("*%s*", Objects.requireNonNull(path)), _ -> {
                var nonexistent = TKit.createTempFile(path);
                try {
                    TKit.deleteIfExists(nonexistent);
                    return nonexistent;
                } catch (IOException ex) {
                    throw new UncheckedIOException(ex);
                }
            });
        }

        private final String label;
        private final Function<JPackageCommand, Path> makePath;
    }

    /**
     * Creates a content from a directory tree.
     *
     * @param path name of directory where to create a directory tree
     */
    private static ContentFactory createDirTreeContent(Path path) {
        if (path.isAbsolute()) {
            throw new IllegalArgumentException();
        }

        return new FileContentFactory(() -> {
            var basedir = TKit.createTempDirectory("content").resolve(path);

            for (var textFile : List.of(
                    entry("woods/moose", "The moose"),
                    entry("woods/bear", "The bear"),
                    entry("woods/trees/jay", "The gray jay")
            )) {
                var src = basedir.resolve(textFile.getKey());
                Files.createDirectories(src.getParent());
                TKit.createTextFile(src, Stream.of(textFile.getValue()));
            }

            for (var emptyDir : List.of("sky")) {
                Files.createDirectories(basedir.resolve(emptyDir));
            }

            return basedir;
        }, path);
    }

    private static ContentFactory createDirTreeContent(String path) {
        return createDirTreeContent(Path.of(path));
    }

    /**
     * Creates a content from a text file.
     *
     * @param path the path where to copy the text file in app image's content directory
     * @param lines the content of the source text file
     */
    private static ContentFactory createTextFileContent(Path path, String ... lines) {
        if (path.isAbsolute()) {
            throw new IllegalArgumentException();
        }

        return new FileContentFactory(() -> {
            var srcPath = TKit.createTempDirectory("content").resolve(path);
            Files.createDirectories(srcPath.getParent());
            TKit.createTextFile(srcPath, Stream.of(lines));
            return srcPath;
        }, path);
    }

    private static ContentFactory createTextFileContent(String path, String ... lines) {
        return createTextFileContent(Path.of(path), lines);
    }

    /**
     * Symlink content factory.
     *
     * @path basedir the directory where to write the content in app image's content
     *       directory
     * @param symlink   the path to the symlink relative to {@code basedir} path
     * @param symlinked the path to the source file for the symlink
     */
    private record SymlinkContentFactory(Path basedir, Path symlink, Path symlinked) implements ContentFactory {
        SymlinkContentFactory {
            for (final var path : List.of(basedir, symlink, symlinked)) {
                if (path.isAbsolute()) {
                    throw new IllegalArgumentException();
                }
            }
        }

        SymlinkContentFactory(String basedir, String symlink, String symlinked) {
            this(Path.of(basedir), Path.of(symlink), Path.of(symlinked));
        }

        @Override
        public Content create(JPackageCommand cmd) {
            final var appContentRoot = createAppContentRoot();

            final var symlinkPath = appContentRoot.resolve(symlinkPath());
            final var symlinkedPath = appContentRoot.resolve(symlinkedPath());
            try {
                Files.createDirectories(symlinkPath.getParent());
                Files.createDirectories(symlinkedPath.getParent());
                // Create the target file for the link.
                Files.writeString(symlinkedPath, symlinkedPath().toString());
                // Create the link.
                Files.createSymbolicLink(symlinkPath, symlinkTarget());
            } catch (IOException ex) {
                throw new UncheckedIOException(ex);
            }

            List<Path> contentPaths;
            if (COPY_IN_RESOURCES) {
                contentPaths = List.of(appContentRoot);
            } else if (basedir.equals(Path.of(""))) {
                contentPaths = Stream.of(symlinkPath(), symlinkedPath()).map(path -> {
                    return path.getName(0);
                }).map(appContentRoot::resolve).toList();
            } else {
                contentPaths = List.of(appContentRoot.resolve(basedir));
            }

            return new Content() {
                @Override
                public List<Path> paths() {
                    return contentPaths;
                }

                @Override
                public Iterable<PathVerifier> verifiers(Path appContentRoot) {
                    return List.of(
                            new RegularFileVerifier(appContentRoot.resolve(symlinkedPath()), symlinkedPath),
                            new SymlinkTargetVerifier(appContentRoot.resolve(symlinkPath()), symlinkTarget())
                    );
                }
            };
        }

        @Override
        public String toString() {
            return String.format("symlink:[%s]->[%s][%s]", symlinkPath(), symlinkedPath(), symlinkTarget());
        }

        private Path symlinkPath() {
            return basedir.resolve(symlink);
        }

        private Path symlinkedPath() {
            return basedir.resolve(symlinked);
        }

        private Path symlinkTarget() {
            return Optional.ofNullable(symlinkPath().getParent()).map(dir -> {
                return dir.relativize(symlinkedPath());
            }).orElseGet(this::symlinkedPath);
        }
    }

    private static final class FileContentFactory implements ContentFactory {

        FileContentFactory(ThrowingSupplier<Path, IOException> factory, Path pathInAppContentRoot) {
            this.factory = ThrowingSupplier.toSupplier(factory);
            this.pathInAppContentRoot = pathInAppContentRoot;
            if (pathInAppContentRoot.isAbsolute()) {
                throw new IllegalArgumentException();
            }
        }

        @Override
        public Content create(JPackageCommand cmd) {
            Path srcPath = factory.get();
            if (!srcPath.endsWith(pathInAppContentRoot)) {
                throw new IllegalArgumentException();
            }

            Path dstPath;
            if (!COPY_IN_RESOURCES) {
                dstPath = srcPath;
            } else {
                var contentDir = createAppContentRoot();
                dstPath = contentDir.resolve(pathInAppContentRoot);
                try {
                    FileUtils.copyRecursive(srcPath, dstPath);
                } catch (IOException ex) {
                    throw new UncheckedIOException(ex);
                }
            }
            return new FileContent(dstPath, pathInAppContentRoot.getNameCount() - 1);
        }

        @Override
        public String toString() {
            return pathInAppContentRoot.toString();
        }

        private final Supplier<Path> factory;
        private final Path pathInAppContentRoot;
    }

    private static final ContentFactory TEST_JAVA = createTextFileContent("apps/PrintEnv.java", "Not what someone would expect");
    private static final ContentFactory TEST_DUKE = createTextFileContent("duke.txt", "Hi Duke!");
    private static final ContentFactory TEST_DIR = createDirTreeContent("apps");
    private static final ContentFactory TEST_BAD = NonExistentPath.create("non-existent");

    // On OSX `--app-content` paths will be copied into the "Contents" folder
    // of the output app image.
    // "codesign" imposes restrictions on the directory structure of "Contents" folder.
    // In particular, random files should be placed in "Contents/Resources" folder
    // otherwise "codesign" will fail to sign.
    // Need to prepare arguments for `--app-content` accordingly.
    private static final boolean COPY_IN_RESOURCES = TKit.isOSX();

    private static final Path RESOURCES_DIR = Path.of("Resources");
}