how to release a codec package with only head files and lib files

Aaron,

You can include the header files (and any other files that you want) in the release by adding something like the following line to your package.bld:

Pkg.otherFiles = ["imgenc_copy_ti.h", "imgenc_copy_ti_priv.h", "makefile"];

Regards,

    Janet

thanks a lot.  it really works..well I have the following questions:

1、in package.bld files ,there are the following codes:

var SRCS = ["imgenc_copy"];

......

Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);

Q:  does SRCS stand for the current codec directory?

2、in the xdc help document, there 's an configuration in the Pkg：config PackageContents.otherSrcs

when I use it like this :

Pkg.attrs.exportAll = false;

Pkg.otherFiles = ["imgenc_copy_ti.h"];

Pkg.otherSrcs=["aa.c"] ; aa.c is a  test file.

Q :the generated tar file didn't include the aa.c file. why?

well, I also didn't completely understand the explaination of the pkg.otherSrcs  in xdc help document：“This array only needs to specify files that are not implicitly specidied via any of the addObjects function; e.g., script files, hand-creafted headers, etc.”

Aaron,

1.  SRCS is just the name of the array containing the files that you are going to add to your library.  You can name it differently, if you like.  The following code would also have worked:

    Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(["imgenc_copy.c"])

2.  Just as your source files do not get included in your tar file (because you have "exportAll" set to false), the same holds for "otherSrcs".  The files in "otherSrcs" get post-processed by the xdc-documentation tools according to xdctools documentation.

Regards,

    Janet

thans for your reply, but the situation of the runtime is  not  so:

for example :  to add  "imgenc_copy_ti.h" , "aa.c" and the lib files,

1  when config the package.bld as this:

var SRCS = ["imgenc_copy"];
Pkg.otherFiles =["imgenc_copy_ti.h"]
Pkg.otherSrcs=["aa.c"]

Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);               or  
Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(Pkg.otherSrcs); or //  I had tried in these three ways

Pkg.addLibrary("lib/imgenc_copy", targ).addO bjects(["aa.c"]);

 Only  "imgenc_copy_ti.h" and the lib files was inclued in relased tar file.

2 when config the package.bld as this:

//var SRCS = ["imgenc_copy"];
Pkg.otherFiles =["imgenc_copy_ti.h","aa.c"]
//Pkg.otherSrcs=["aa.c"]

Pkg.addLibrary("lib/imgenc_copy", targ);

//Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);

noticed that  some  I had commented some lines.

the files (imgenc_copy, aa.c ,lib files )was correctly inclued in the relased tar file.

Does there are any wrong configurations in the first example? hope you can give an example of how to correctly use these configurations.

the following is the  entire contents of my package.bld :

/*
 *  ======== package.bld ========
 */

var Build = xdc.useModule('xdc.bld.BuildEnvironment');
var Pkg = xdc.useModule('xdc.bld.PackageContents');

/* when constructing a release, release everything */
//Pkg.attrs.exportAll = true;
Pkg.attrs.exportAll = false;
// Uncomment this to build debug binaries
//Pkg.attrs.profile = "debug";

/*
 * Create an array containing the files to include in this package.  Note
 * that the extension is added by XDC, so it need not be explicitly specified.
 */

//var SRCS = ["imgenc_copy"];
Pkg.otherFiles =["imgenc_copy_ti.h","aa.c","imgenc_copy.c"]
//Pkg.otherSrcs=["aa.c"]

for (var i = 0; i < Build.targets.length; i++) {
    var targ = Build.targets[i];

    print("building for target " + targ.name + " ...");

    /*
     * Add a library to this package and add the files described in
     * SRCS to the library.
     */
     Pkg.addLibrary("lib/imgenc_copy", targ);
    //Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);
    //Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(Pkg.otherSrcs);
    //Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(["aa.c"]);
}

Aaron,

In the following case:

1  when config the package.bld as this:

var SRCS = ["imgenc_copy"];
Pkg.otherFiles =["imgenc_copy_ti.h"]
Pkg.otherSrcs=["aa.c"]

Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);               or  
Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(Pkg.otherSrcs); or //  I had tried in these three ways

Pkg.addLibrary("lib/imgenc_copy", targ).addO bjects(["aa.c"]);

 Only  "imgenc_copy_ti.h" and the lib files was inclued in relased tar file.

you only get "imgenc_copy_ti.h" and the lib files in the tar file, because Pkg.otherFiles only contains "imgenc_copy_ti.h".  If you also want the file, "aa.c", added to the tar file, you need to add it to Pkg.otherFiles[], as you have in the second case.

Best regards,

    Janet

thank you very much。while the last question is ：

Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);

does the addObjects function  means that to compiled the src files in the library 。no matter Pkg.attrs.exportAll is true or false？

if true ，then the src files will included in the package ；if false they wouldn't 。

Am I right?

AaronYang said:

thank you very much。while the last question is ：

Pkg.addLibrary("lib/imgenc_copy", targ).addObjects(SRCS);

does the addObjects function  means that to compiled the src files in the library 。no matter Pkg.attrs.exportAll is true or false？

The addObjects function means: "compile the specified sources and add only the _compiled object files_ to the library (or executable)".

AaronYang said:

if true ，then the src files will included in the package ；if false they wouldn't 。

Am I right?

The inclusion of source files is controlled independently of the object files derived from the sources.  By default, when you build a package's release, _only_ compiled object files are included. 

To get sources in the package's release, you must explicitly specify (for example, via Pkg.attrs.export* properties or Pkg.other* lists)  the sources to include.

Hi,

Janet.

Could you help me with the problem here.

Hope for your help.

Regards,

Yang