-
Notifications
You must be signed in to change notification settings - Fork 194
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Call the API tools directly without using ApiAnalysisApplication
This replaces ApiAnalysisApplication usage by a more direct approach that do not require us to pass file lists around and directly class the ApiTools. This is also much more flexible in regard to debugging and additional printouts but still retains that we can consume dynamic implementation from P2 repositories. Beside that we can now give much better failure report to the user. (cherry picked from commit 8526ce0)
- Loading branch information
Showing
6 changed files
with
641 additions
and
100 deletions.
There are no files selected for viewing
274 changes: 274 additions & 0 deletions
274
tycho-apitools-plugin/src/main/java/org/eclipse/tycho/apitools/ApiAnalysis.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,274 @@ | ||
/******************************************************************************* | ||
* Copyright (c) 2023 Christoph Läubrich and others. | ||
* This program and the accompanying materials | ||
* are made available under the terms of the Eclipse Public License 2.0 | ||
* which accompanies this distribution, and is available at | ||
* https://www.eclipse.org/legal/epl-2.0/ | ||
* | ||
* SPDX-License-Identifier: EPL-2.0 | ||
* | ||
* Contributors: | ||
* Christoph Läubrich - initial API and implementation | ||
*******************************************************************************/ | ||
package org.eclipse.tycho.apitools; | ||
|
||
import java.io.File; | ||
import java.io.IOException; | ||
import java.io.InputStream; | ||
import java.io.Serializable; | ||
import java.nio.file.Files; | ||
import java.nio.file.Path; | ||
import java.util.ArrayList; | ||
import java.util.Collection; | ||
import java.util.HashMap; | ||
import java.util.List; | ||
import java.util.Objects; | ||
import java.util.Properties; | ||
import java.util.concurrent.Callable; | ||
|
||
import org.eclipse.core.resources.ICommand; | ||
import org.eclipse.core.resources.IProject; | ||
import org.eclipse.core.resources.IProjectDescription; | ||
import org.eclipse.core.resources.IResource; | ||
import org.eclipse.core.resources.IWorkspace; | ||
import org.eclipse.core.resources.IWorkspaceDescription; | ||
import org.eclipse.core.resources.ResourcesPlugin; | ||
import org.eclipse.core.runtime.CoreException; | ||
import org.eclipse.core.runtime.IPath; | ||
import org.eclipse.core.runtime.NullProgressMonitor; | ||
import org.eclipse.core.runtime.jobs.Job; | ||
import org.eclipse.osgi.service.resolver.ResolverError; | ||
import org.eclipse.pde.api.tools.internal.BundleListTargetLocation; | ||
import org.eclipse.pde.api.tools.internal.FilterStore; | ||
import org.eclipse.pde.api.tools.internal.builder.BaseApiAnalyzer; | ||
import org.eclipse.pde.api.tools.internal.builder.BuildContext; | ||
import org.eclipse.pde.api.tools.internal.model.ApiModelFactory; | ||
import org.eclipse.pde.api.tools.internal.model.BundleComponent; | ||
import org.eclipse.pde.api.tools.internal.model.ProjectComponent; | ||
import org.eclipse.pde.api.tools.internal.model.SystemLibraryApiComponent; | ||
import org.eclipse.pde.api.tools.internal.provisional.ApiPlugin; | ||
import org.eclipse.pde.api.tools.internal.provisional.IApiFilterStore; | ||
import org.eclipse.pde.api.tools.internal.provisional.model.IApiBaseline; | ||
import org.eclipse.pde.api.tools.internal.provisional.model.IApiComponent; | ||
import org.eclipse.pde.api.tools.internal.provisional.problems.IApiProblem; | ||
import org.eclipse.pde.core.target.ITargetDefinition; | ||
import org.eclipse.pde.core.target.ITargetLocation; | ||
import org.eclipse.pde.core.target.ITargetPlatformService; | ||
import org.eclipse.pde.core.target.LoadTargetDefinitionJob; | ||
import org.eclipse.pde.core.target.TargetBundle; | ||
import org.eclipse.pde.internal.core.target.TargetPlatformService; | ||
import org.osgi.framework.Bundle; | ||
import org.osgi.framework.FrameworkUtil; | ||
|
||
public class ApiAnalysis implements Serializable, Callable<ApiAnalysisResult> { | ||
|
||
private Collection<String> baselineBundles; | ||
private Collection<String> targetBundles; | ||
private String baselineName; | ||
private String apiFilterFile; | ||
private String projectDir; | ||
private boolean debug; | ||
private String apiPreferences; | ||
private String binaryArtifact; | ||
|
||
public ApiAnalysis(Collection<Path> baselineBundles, Collection<Path> dependencyBundles, String baselineName, | ||
Path apiFilterFile, Path apiPreferences, Path projectDir, boolean debug, Path binaryArtifact) { | ||
this.targetBundles = dependencyBundles.stream().map(ApiAnalysis::pathAsString).toList(); | ||
this.baselineBundles = baselineBundles.stream().map(ApiAnalysis::pathAsString).toList(); | ||
this.baselineName = baselineName; | ||
this.apiFilterFile = pathAsString(apiFilterFile); | ||
this.apiPreferences = pathAsString(apiPreferences); | ||
this.projectDir = pathAsString(projectDir); | ||
this.binaryArtifact = pathAsString(binaryArtifact); | ||
this.debug = debug; | ||
} | ||
|
||
@Override | ||
public ApiAnalysisResult call() throws Exception { | ||
ApiAnalysisResult result = new ApiAnalysisResult(); | ||
printVersion(); | ||
disableAutoBuild(); | ||
setTargetPlatform(); | ||
deleteAllProjects(); | ||
BundleComponent projectComponent = importProject(); | ||
IApiBaseline baseline = createBaseline(baselineBundles, baselineName + " - baseline"); | ||
ResolverError[] resolverErrors = projectComponent.getErrors(); | ||
if (resolverErrors != null && resolverErrors.length > 0) { | ||
for (ResolverError error : resolverErrors) { | ||
result.addResolverError(error); | ||
} | ||
} | ||
IApiFilterStore filterStore = getApiFilterStore(projectComponent); | ||
Properties preferences = getPreferences(); | ||
BaseApiAnalyzer analyzer = new BaseApiAnalyzer(); | ||
try { | ||
analyzer.setContinueOnResolverError(true); | ||
analyzer.analyzeComponent(null, filterStore, preferences, baseline, projectComponent, new BuildContext(), | ||
new NullProgressMonitor()); | ||
IApiProblem[] problems = analyzer.getProblems(); | ||
for (IApiProblem problem : problems) { | ||
result.addProblem(problem); | ||
debug(String.valueOf(problem)); | ||
} | ||
} finally { | ||
analyzer.dispose(); | ||
ResourcesPlugin.getWorkspace().save(true, new NullProgressMonitor()); | ||
} | ||
return result; | ||
} | ||
|
||
private BundleComponent importProject() throws CoreException, IOException { | ||
IPath projectPath = IPath.fromOSString(projectDir); | ||
IPath projectDescriptionFile = projectPath.append(IProjectDescription.DESCRIPTION_FILE_NAME); | ||
IProjectDescription projectDescription = ResourcesPlugin.getWorkspace() | ||
.loadProjectDescription(projectDescriptionFile); | ||
projectDescription.setLocation(projectPath); | ||
projectDescription.setBuildSpec(new ICommand[0]); | ||
IProject project = ResourcesPlugin.getWorkspace().getRoot().getProject(projectDescription.getName()); | ||
project.create(projectDescription, new NullProgressMonitor()); | ||
project.open(new NullProgressMonitor()); | ||
IApiBaseline workspaceBaseline = ApiPlugin.getDefault().getApiBaselineManager().getWorkspaceBaseline(); | ||
IApiComponent component = workspaceBaseline.getApiComponent(project); | ||
if (component instanceof ProjectComponent projectComponent) { | ||
debug("Project component was found"); | ||
return projectComponent; | ||
} | ||
IApiComponent[] components = workspaceBaseline.getApiComponents(); | ||
for (IApiComponent c : components) { | ||
String location = c.getLocation(); | ||
if (location != null && IPath.fromOSString(location).equals(projectPath) | ||
&& c instanceof BundleComponent bundle) { | ||
debug("Fallback to binary bundle component"); | ||
return bundle; | ||
} | ||
} | ||
if (binaryArtifact != null) { | ||
debug("Fallback to binary artifact"); | ||
// TODO we would like to pass the imported project then see | ||
// https://github.com/eclipse-pde/eclipse.pde/pull/786 | ||
IApiComponent binaryComponent = ApiModelFactory.newApiComponent(workspaceBaseline, binaryArtifact); | ||
if (binaryComponent instanceof BundleComponent bundle) { | ||
workspaceBaseline.addApiComponents(new IApiComponent[] { bundle }); | ||
return bundle; | ||
} | ||
|
||
} | ||
throw new RuntimeException("Can't import project"); | ||
} | ||
|
||
private void deleteAllProjects() throws CoreException { | ||
for (IProject project : ResourcesPlugin.getWorkspace().getRoot().getProjects()) { | ||
project.delete(IResource.NEVER_DELETE_PROJECT_CONTENT | IResource.FORCE, new NullProgressMonitor()); | ||
} | ||
} | ||
|
||
private void disableAutoBuild() throws CoreException { | ||
IWorkspace workspace = ResourcesPlugin.getWorkspace(); | ||
IWorkspaceDescription desc = workspace.getDescription(); | ||
desc.setAutoBuilding(false); | ||
workspace.setDescription(desc); | ||
} | ||
|
||
private Properties getPreferences() throws IOException { | ||
Properties properties = new Properties(); | ||
if (apiPreferences != null) { | ||
Path path = Path.of(apiPreferences); | ||
if (Files.isRegularFile(path)) { | ||
try (InputStream stream = Files.newInputStream(path)) { | ||
properties.load(stream); | ||
} | ||
} | ||
} | ||
return properties; | ||
} | ||
|
||
private void printVersion() { | ||
Bundle apiToolsBundle = FrameworkUtil.getBundle(ApiModelFactory.class); | ||
if (apiToolsBundle != null) { | ||
debug("API Tools version: " + apiToolsBundle.getVersion()); | ||
} | ||
} | ||
|
||
private IApiBaseline createBaseline(Collection<String> bundles, String name) throws CoreException { | ||
debug("==== " + name + " ===="); | ||
IApiBaseline baseline = ApiModelFactory.newApiBaseline(name); | ||
List<IApiComponent> baselineComponents = new ArrayList<IApiComponent>(); | ||
for (String baselineBundle : bundles) { | ||
IApiComponent component = ApiModelFactory.newApiComponent(baseline, baselineBundle); | ||
if (component != null) { | ||
debug(component.getSymbolicName() + " " + component.getVersion() + " -- " | ||
+ new File(Objects.requireNonNullElse(component.getLocation(), "Unknown")).getName()); | ||
baselineComponents.add(component); | ||
} | ||
} | ||
baseline.addApiComponents(baselineComponents.toArray(IApiComponent[]::new)); | ||
for (IApiComponent component : baseline.getApiComponents()) { | ||
if (component instanceof SystemLibraryApiComponent systemLibrary) { | ||
debug("System Component:"); | ||
debug("\tVersion: " + systemLibrary.getVersion()); | ||
debug("\tLocation: " + systemLibrary.getLocation()); | ||
for (String ee : systemLibrary.getExecutionEnvironments()) { | ||
debug("\tExecution Environment: " + ee); | ||
} | ||
} | ||
|
||
} | ||
return baseline; | ||
} | ||
|
||
private IApiFilterStore getApiFilterStore(BundleComponent bundle) { | ||
return new FilterStore(bundle) { | ||
@Override | ||
protected synchronized void initializeApiFilters() { | ||
if (fFilterMap == null) { | ||
fFilterMap = new HashMap<>(5); | ||
if (apiFilterFile != null) { | ||
Path path = Path.of(apiFilterFile); | ||
if (Files.isRegularFile(path)) { | ||
try (InputStream stream = Files.newInputStream(path)) { | ||
readFilterFile(stream); | ||
} catch (IOException e) { | ||
debug(e.toString()); | ||
} | ||
} | ||
} | ||
} | ||
} | ||
}; | ||
} | ||
|
||
private void debug(String string) { | ||
if (debug) { | ||
System.out.println(string); | ||
} | ||
} | ||
|
||
private void setTargetPlatform() throws IOException, CoreException, InterruptedException { | ||
ITargetPlatformService service = TargetPlatformService.getDefault(); | ||
ITargetDefinition target = service.newTarget(); | ||
target.setName("buildpath"); | ||
TargetBundle[] bundles = targetBundles.stream()// | ||
.map(absoluteFile -> { | ||
try { | ||
return new TargetBundle(new File(absoluteFile)); | ||
} catch (CoreException e) { | ||
debug(e.toString()); | ||
return null; | ||
} | ||
}).filter(Objects::nonNull)// | ||
.toArray(TargetBundle[]::new); | ||
target.setTargetLocations(new ITargetLocation[] { new BundleListTargetLocation(bundles) }); | ||
service.saveTargetDefinition(target); | ||
Job job = new LoadTargetDefinitionJob(target); | ||
job.schedule(); | ||
job.join(); | ||
} | ||
|
||
private static String pathAsString(Path path) { | ||
if (path != null) { | ||
return path.toAbsolutePath().toString(); | ||
} | ||
return null; | ||
} | ||
|
||
} |
Oops, something went wrong.