Installation

Previous Next Contents

3 Installation

This chapter explains how to install the Jakarta Annotations TCK software.

After installing the software according to the instructions in this chapter, proceed to Chapter 4, "Setup and Configuration," for instructions on configuring your test environment.

3.1 Obtaining a Compatible Implementation

Each compatible implementation (CI) will provide instructions for obtaining their implementation. Jakarta Annotations 3.0 is a compatible implementation which may be obtained from https://projects.eclipse.org/projects/ee4j.ca

3.2 Installing the Software

Before you can run the Annotations TCK tests, you must install and set up the following software components:

  • Java SE 17+

  • A CI for Annotations 3.0, one example is Jakarta Annotations 3.0

  • Annotations TCK version 3.0

  • The Annotations 3.0 Vendor Implementation (VI)

  • Any Jupiter API compatible test runner (eg. Apache Maven 3.6.3+)

Follow these steps:

  1. Install the Java SE 17+ software, if it is not already installed.
    Download and install the Java SE 17+ software from http://www.oracle.com/technetwork/java/javase/downloads/index.html. Refer to the installation instructions that accompany the software for additional information.

  2. Install the build tool that will be used to run the TCK, if it is not already installed.
    It will be convenient to use Apache Maven 3.6.3+ for running the tests. The test kit is not depended on Maven, any build tool compatible with Jupiter API is suffitient.

  3. Install the Annotations TCK 3.0 software.

    1. Copy or download the Annotations TCK software to your local system.
      You can obtain the Annotations TCK software from the Jakarta EE site https://jakarta.ee/specifications/annotations/3.0/.

    2. Use the unzip command to extract the bundle in the directory of your choice:
      unzip jakarta-annotations-tck-x.y.z.zip

  4. Install a Annotations 3.0 Compatible Implementation.
    A Compatible Implementation is used to validate your initial configuration and setup of the Annotations TCK 3.0 tests, which are explained further in Chapter 4, "Setup and Configuration."
    The Compatible Implementations for Annotations are listed on the Jakarta EE Specifications web site: https://jakarta.ee/specifications/annotations/3.0/.

  5. Install the Annotations VI to be tested.
    Follow the installation instructions for the particular VI under test.


Previous Next Contents
Eclipse Foundation Logo  Copyright © 2017, 2021 Oracle and/or its affiliates. All rights reserved.