/**

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

 * All rights reserved.

 * This component and the accompanying materials are made available

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

 * which accompanies this distribution, and is available

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

 *

 * Initial Contributors:

 * Symbian Foundation - initial contribution.

 * Contributors:

 * Description:

 * Overview:

 * Details:

 * Platforms/Drives/Compatibility:

 * Assumptions/Requirement/Pre-requisites:

 * Failures and causes:

 */

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

import org.symbian.tools.tmw.core.projects.ITMWProject;

/**

 * Manages mobile web runtimes.

 * 

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

 */

public interface IMobileWebRuntimeManager {

    /**

     * Shorthand method to obtain packager for project default runtime.

     */

    IPackager getPackager(ITMWProject project);

    /**

     * Returns packager that can create a packaged application for provided 

     * runtime from the given project.

     * 

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

     * specified runtime

     */

    IPackager getPackager(ITMWProject project, IMobileWebRuntime runtime);

    /**

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

     * 

     * @throws IllegalArgumentException if there is no runtime with the 

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

     * install or coding error on IDE provider side.

     */

    IMobileWebRuntime getRuntime(String id, String version);

    /**

     * @return list of all runtimes known to an IDE

     */

    IMobileWebRuntime[] getAllRuntimes();

}