Build Citrus from the source

vkrajacic89

Hello,

I would like to use source from citrus and compile it instead of using swc.

My reasons for this are as follows:
* You always get to use latest features from the engine.
* You can examine Citrus code from within your project.

My question is how do I compile Citrus just for classic flash display list with nape physics using only flash 10.1? I'm currently using IntellijIDEA as a working IDE.

Thanks,
Vjeko

gsynuh

Hi vkrajacic89,

it's fairly easy,
you want the src folder of the git repository to be a classpath as well as the srclib folder (it contains extras and extensions used in source format)

Then you want all the .swc's in the lib folder to be included as libraries.

Doesn't matter what you'll be using from those, the IDE should compile selectively.

edit:
specifics for intelliJIDEA :

classpaths is more of a flash develop terminology I understand, in intelliJ I think you want modules.

File > Project Structure > Modules
press the [+ Add content root] button, select the src folder , ok, then do the same for src lib.

in the same Project Structure window you've got libraries , press the [+] and add the swcs in the lib folder.

note: there's also the global libraries which I suppose can be used for setting up libraries to be reconsidered accross projects.

vkrajacic89

Well, actually I already have all this set up. But how do I compile only part that I need? Because when I set target player to 10.1 the build fails. Most of the dependencies require 11.1 or higher...

gsynuh

Well,
I just tried a web project , targeting 10.1 just like you (going through the new project wizard)

I imported all modules and sources as I thought I would.

Here's my setup and compiling works :

Now I don't actually know how to set things up properly, maybe this is wrong,
on the left you see src/src libs (added via project structure >modules), I had to right click on them and Mark Directory as src so I might have done something wrong in the first place here.
I suppose you know better how to set that up.

Anyway, autocomplete works when I mention something from citrus and I also am able to import signals from the signal.swc so I assume I included them correctly.

I'm using CitrusEngine, not StarlingCitrusEngine because you said you would be using the flash display list only.

the compiling and swf runs without errors...
Should I check something else ?

vkrajacic89

Could you copy contents of .iml files here? They should be located in folders: src, srclib and src(main project).

gsynuh

Alright if that helps, for this project I posted a screen of (untitled4) I only have this .iml

<?xml version="1.0" encoding="UTF-8"?>
<module type="Flex" version="4">
  <component name="FlexBuildConfigurationManager" active="untitled4">
    <configurations>
      <configuration name="untitled4" main-class="Untitled4" output-file="Untitled4.swf" output-folder="$MODULE_DIR$/out/production/untitled4" use-html-wrapper="true" wrapper-template-path="$MODULE_DIR$/html-template">
        <dependencies target-player="10.1">
          <entries>
            <entry library-name="CE" library-level="project">
              <dependency linkage="Merged" />
            </entry>
          </entries>
          <sdk name="flexsdk" />
        </dependencies>
        <compiler-options />
        <packaging-air-desktop />
        <packaging-android />
        <packaging-ios />
      </configuration>
    </configurations>
    <compiler-options />
  </component>
  <component name="NewModuleRootManager" inherit-compiler-output="true">
    <exclude-output />
    <content url="file://C:/AS3 Libraries/Citrus-Engine/src">
      <sourceFolder url="file://C:/AS3 Libraries/Citrus-Engine/src" isTestSource="false" />
    </content>
    <content url="file://C:/AS3 Libraries/Citrus-Engine/srclib">
      <sourceFolder url="file://C:/AS3 Libraries/Citrus-Engine/srclib" isTestSource="false" />
    </content>
    <content url="file://$MODULE_DIR$">
      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
    </content>
    <orderEntry type="jdk" jdkName="flexsdk" jdkType="Flex SDK Type (new)" />
    <orderEntry type="sourceFolder" forTests="false" />
    <orderEntry type="library" exported="" name="CE" level="project" />
  </component>
</module>

vkrajacic89

As far as I can see, you didn't actually add new modules. You added source folders from Citrus to your project and included Citrus lib dependencies. That actually works, though I still had to edit some code to make it 10.1 compatible. For instance, some classes use Point.setTo and Point.copyFrom functions that were added in flash 11. Also SoundChannelUtil class use Sound.loadPCMFromByteArray function that was added in flash 11 as well.
But I was actually looking for something more elegant, like creating my own swc from Citrus source. The reason for that is because swcs in bin folder on github are 4 months old. To make concrete question out of this, how was CEV3-1-7-Nape.swc in folder bin built?

gsynuh

I actually have only one module named CE
which contains all .swc's from the CE lib folder

Sorry we didn't keep compatibility for older players like that with setTo and other functions...

I have no experience with building the .swc myself, 3.1.8 is coming anyway, we just had a look at some latest compatibility issues

vkrajacic89

Ok, I will stick with adding source folders to my project for now. Thanks for help!

gsynuh

Just a little update for you or anyone interested in this topic , Aymeric updated the ant files for the latest CE source to be built correctly.

vkrajacic89

Thanks for info. I don't know if I did something wrong or you guys missed something but I get following error when I try to build from ant file.
D:\Projects\Platformer\Citrus-Engine\ant\build.xml:62: Execute failed: java.io.IOException: Cannot run program "C:\Users\Aymeric\Workspace\SDKs\flex_sdk_4.6\bin\compc.exe": CreateProcess error=2, The system cannot find the file specified

Messi89

Hi vkrajacic89

You need to put your flexSDK directory on ant/build.properties

change the "FLEX_HOME_WINDOWS = ....."

Good luck