1 /**

     2  * Copyright (c) 2010 Symbian Foundation and/or its subsidiary(-ies).

     3  * All rights reserved.

     4  * This component and the accompanying materials are made available

     5  * under the terms of the License "Eclipse Public License v1.0"

     6  * which accompanies this distribution, and is available

     7  * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8  *

     9  * Initial Contributors:

    10  * Symbian Foundation - initial contribution.

    11  * Contributors:

    12  * Description:

    13  * Overview:

    14  * Details:

    15  * Platforms/Drives/Compatibility:

    16  * Assumptions/Requirement/Pre-requisites:

    17  * Failures and causes:

    18  */

    19 package org.symbian.tools.tmw.core.runtimes;

    20 

    21 import org.symbian.tools.tmw.core.projects.IMTWProject;

    22 

    23 /**

    24  * Manages mobile web runtimes.

    25  * 

    26  * @author Eugene Ostroukhov (eugeneo@symbian.org)

    27  */

    28 public interface IMobileWebRuntimeManager {

    29     /**

    30      * Shorthand method to obtain packager for project default runtime.

    31      */

    32     IPackager getPackager(IMTWProject project);

    33 

    34     /**

    35      * Returns packager that can create a packaged application for provided 

    36      * runtime from the given project.

    37      * 

    38      * @return <code>null</null> if the project cannot be packaged for 

    39      * specified runtime

    40      */

    41     IPackager getPackager(IMTWProject project, IMobileWebRuntime runtime);

    42 

    43     /**

    44      * Returns runtimes for the given ID. Runtime will not be null.

    45      * 

    46      * @throws IllegalArgumentException if there is no runtime with the 

    47      * provided ID. It is assumed that this can only be caused by a broken 

    48      * install or coding error on IDE provider side.

    49      */

    50     IMobileWebRuntime getRuntime(String id, String version);

    51 

    52     /**

    53      * @return list of all runtimes known to an IDE

    54      */

    55     IMobileWebRuntime[] getAllRuntimes();

    56 }