无法运行UIMA Ruta程序：导入功能异常求助

Hey there, let's work through your UIMA Ruta problems step by step—since you're totally new to this, I'll keep things straightforward and actionable:

1. Fixing the "Package declaration doesn't match project structure" error #

This is a standard Java/Ruta project structure rule: your PACKAGE statement must exactly match the folder hierarchy where your Ruta file lives.

For example, if you write PACKAGE uima.ruta.example;:

• First, check your project's Ruta source folders: right-click your project > Properties > UIMA Ruta > look under Source Folders (usually src/ruta or src/main/ruta by default)
• Create a nested folder structure under that source folder: uima/ruta/example
• Move your Ruta file into that example folder. The package declaration will now match the structure, and the red error should disappear.

2. Why Quick Ruta Run does nothing & Missing "ruta" libraries #

First, let's clear up a confusion: ruta.example is not a real library—it's just an example package name used in the official guide. You don't need to download it.

The core Ruta libraries are already included in the UIMA Ruta Workbench plugin you installed, but your project might not be linked to them correctly. Here's how to fix it:

• Make sure you created a UIMA Ruta Project (not a regular Java project). If you used the wrong project type, start over: go to File > New > Other > UIMA > UIMA Ruta Project—the wizard will auto-configure all required dependencies for you.
• If you already have an existing project, manually add the Ruta libraries: right-click your project > Build Path > Add Libraries > UIMA Ruta Libraries > select your installed version (2.6.1) and confirm. This will pull in all core Ruta jars like uima-ruta-core.jar and uima-ruta-common.jar.

You don't need to hunt for these jars manually—they're stored in your Eclipse plugin directory (folders like org.apache.uima.ruta_2.6.1), but the build path setup handles the references automatically.

3. Command-line execution for UIMA Ruta #

Great question! UIMA Ruta does support command-line runs, but the official guide prioritizes the Eclipse Workbench for a few good reasons:

• Ruta has powerful visual tools (rule editors, annotation previews, debuggers) that don't exist in the command line—these are huge helps for new users learning the syntax.
• UIMA/Ruta projects require a lot of configuration (type systems, analysis engine descriptors, dependency management) that the Eclipse plugin handles automatically. Doing this manually via command line is much more error-prone.
• If you still want to try command-line execution, you can package your Ruta project into a PEAR (Portable UIMA Application Resource) file in Eclipse first, then use UIMA's runPear.sh (Linux/macOS) or runPear.bat (Windows) tools to execute it. But this requires getting the project working in Eclipse first, so it's not a "start from scratch" command-line workflow.

内容的提问来源于stack exchange，提问作者svtz