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.mtw.core.runtimes;

    20 

    21 import java.io.File;

    22 

    23 import org.eclipse.core.resources.IResource;

    24 import org.eclipse.core.runtime.CoreException;

    25 import org.eclipse.core.runtime.IPath;

    26 import org.eclipse.core.runtime.IProgressMonitor;

    27 import org.symbian.tools.mtw.core.projects.IMTWProject;

    28 

    29 /**

    30  * Packager creates a runtime-specific application package that can be 

    31  * deployed to compatible targets.

    32  * 

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

    34  */

    35 public interface IPackager {

    36     /**

    37      * Synchronously packages application for the specified runtime.

    38      * 

    39      * @return {@link File} denoting location of the application package that can be deployed to targets

    40      */

    41     File packageApplication(IMTWProject project, IProgressMonitor monitor)

    42             throws CoreException;

    43 

    44     /**

    45      * @return application package root-relative path where the workspace resource will be packaged. Can be <code>null</code>.

    46      */

    47     IPath getPathInPackage(IResource resource);

    48 

    49     /**

    50      * @return file type of the application archive

    51      */

    52     String getFileType(IMTWProject project);

    53 

    54     /**

    55      * @return target runtime that this packager packages for

    56      */

    57     IMobileWebRuntime getTargetRuntime();

    58 

    59     /**

    60      * @return source runtime. It is the runtime that the project should target to be packaged with this packager.

    61      */

    62     IMobileWebRuntime getSourceRuntime();

    63 }