And a related question: will the MavenImporter automatically find and use my $HOME/.m2/settings.xml, and use the local Maven repository on my machine?  If not, how can I make it do that?

Thanks again,

Richard

I figured out that I was doing it wrong.  I was looking at Maven's dependency scopes, when what I really wanted was all the dependencies on the Maven project's runtime classpath.  The runtime classpath is calculated based on the scopes of the dependencies plus one or two other things.

Shrinkwrap doesn't have a ready-made MavenResolutionStrategy that only chooses dependencies which would be on the runtime classpath, but I wrote a simple one like this:

{code}
public class RuntimeClasspathOnlyStrategy implements MavenResolutionStrategy, MavenResolutionFilter
{
    private final MavenResolutionFilter[] resolutionFilters;
 
    public RuntimeClasspathOnlyStrategy()
    {
        this.resolutionFilters = new MavenResolutionFilter[] { this };
    }
 
    @Override
    public MavenResolutionFilter[] getPreResolutionFilters()
    {
        return resolutionFilters;
    }
 
    @Override
    public MavenResolutionFilter[] getResolutionFilters()
    {
        return resolutionFilters;
    }
 
    @Override
    public TransitiveExclusionPolicy getTransitiveExclusionPolicy()
    {
        return DefaultTransitiveExclusionPolicy.INSTANCE;
    }
 
    @Override
    public boolean accepts(MavenDependency dependency, List<MavenDependency> dependenciesForResolution)
    { 
        return PackagingType.JAR.equals(dependency.getPackaging())
            && ( ScopeType.COMPILE.equals(dependency.getScope()) || ScopeType.RUNTIME.equals(dependency.getScope()) );
    }
}
{code}

Now, I think this might actually be too simple: there might be some subtle rules in Maven about resolving conflicts which I don't really understand (see for example Aether's JavaEffectiveScopeCalculator).

Also, my strategy filters dependencies pre-resolution, which makes building the war much quicker, but might be wrong for some other subtle reason.  The Shrinkwrap AcceptScopesStrategy doesn't do any pre-resolution filtering, but I don't know why.

Anyway it seems to produce the right result in my project for now - maybe other people will find it useful.  If I've done this wrong, please let me know!

Cheers.

Awesome, thank you very much for the update Karel!