Posts Tagged “SomaCore”

I’ve just uploaded a new video tutorial (48 min) for my lightweight AS3 MVC Framework SomaCore.

You can now get started with it. I explain how to create the framework instance, how to create a wire, create views, create commands and how to intercept them.

SomaCore Getting Started Video Tutorial

I hope you like it!

Vote in HexoSearch

Comments 1 Comment »

Hi everyone,

In case you didn't notice that I released an new minimal AS3 MVC Framework some time ago, SomaCore is available on this page.

I call it minimal because it is very lightweight, yet powerful and non-intrusive. You don't have much to learn if you're used to MVC framework of any sort.

I made an update today, the second one in months because it won't change a lot, the structure is there. All the sources and demo have been updated.

You can also replace any kind of previous use of the framework, the only feature added is a dispose method that will remove everything that has been created in the framework. Mostly useful in case you're creating several instance of the framework, it will now be correctly garbage collected.

Once you've created a instance of the framework:

Actionscript:
  1. var app:ISoma = new Application(stage);

The only things you need to do is

Actionscript:
  1. app.dispose();
  2. app = null;

Here is what it is doing to the components that have been added to the frameworks:

- all wires will be removed. On each wire, the dispose method will be called. You can overwrite this dispose method in your wires subclasses.

- all models will be removed. On each model, the dispose method will be called. You can overwrite this dispose method in your models subclasses.

- all commands will be removed

- all views will be removed but not removed from the display list, that's your job. On each view, a dispose method will be called if it exists. You can create this dispose method in your views:

Actionscript:
  1. public function dispose():void {
  2.     // dispose objects, graphics and events listeners
  3. }

It important to say that all the components will be removed from the framework, but that's your matter to properly destroyed what you're creating in order to be garbage collected.

A quick info for my plans because I've silent lately (busy).

I'll make a BaseUI release in the next weeks, a completely rebuilt and optimized version 4. It is ready but I need to finish the documentation.

After that I plan to make more examples and screen cast about the SomaCore Framework.

I just wanted to say that I'm rarely happy about what I'm producing, because I like things to be... perfect. Of course, perfection can't be reached, but that is pushing me to create the better code I can, at my level.

I'm now using SomaCore in some projects. One is a relatively complicated AIR Modular Application for children. And for once, I'm very happy with what I've done with SomaCore. It has been a great help really, I should say that it saves me a lot of troubles when changes happened because I built the application how I wanted it, without "framework-fight" and as much flexible as I could. It just made me more responsive to any kind of changes in the project.

For this reason, I'll try to push SomaCore further by making more demos, videos, examples, documentation, wires concept and so on.

I still have plans to create a new version of the first automated framework Soma MVC, and its source generator, based on SomaCore.

Happy development!

Vote in HexoSearch

Comments 3 Comments »

I needed to watch objects to know if they were properly garbage collected or not, so I've added a GC Monitor in the SomaCore Debugger. It is pretty easy to use and I think very useful if you start to care about the memory that the Flash Player is using and global performance.

Demo Flash (garbage collection monitor)

SomaCore Flash AS3 Demo - Garbage Collection

View Demo
View Source
Download Source

The concept to use it is to "register" an object, such as a Sprite or anything, with a name.

The first step is to create the debugger. If you're using the framework SomaCore, you'll find some demo by clicking here.
And if you want to use the debugger without using SomaCore, here is a snippet to create the application and debugger:

Actionscript:
  1. package {
  2.     import flash.display.Sprite;
  3.     import com.soma.core.Soma;
  4.     import com.soma.core.interfaces.ISoma;
  5.     import com.soma.debugger.SomaDebugger;
  6.     import com.soma.debugger.vo.SomaDebuggerVO;
  7.     import com.soma.debugger.events.SomaDebuggerEvent;
  8.     public class Main extends Sprite {
  9.         function Main() {
  10.             // create soma application
  11.             var app:ISoma = new Soma(stage);
  12.             // create debugger options
  13.             var vo:SomaDebuggerVO = new SomaDebuggerVO(app, SomaDebugger.NAME_DEFAULT, [], true, false);
  14.             // create debugger
  15.             var debugger:SomaDebugger = app.createPlugin(SomaDebugger, vo) as SomaDebugger;
  16.             // use debugger
  17.             debug("Hello Debugger");
  18.             debug(this);
  19.             debug(app);
  20.         }
  21.         private function debug(obj:Object):void {
  22.             // use app.dispatchEvent() from a class that is not in the display list
  23.             dispatchEvent(new SomaDebuggerEvent(SomaDebuggerEvent.PRINT, obj));
  24.             // events available:
  25.             // SomaDebuggerEvent.SHOW_DEBUGGER;
  26.             // SomaDebuggerEvent.CLEAR;
  27.             // SomaDebuggerEvent.PRINT;
  28.             // SomaDebuggerEvent.HIDE_DEBUGGER;
  29.             // SomaDebuggerEvent.MOVE_TO_TOP;
  30.         }
  31.     }
  32. }

Register an object to watch it:

Actionscript:
  1. dispatchEvent(new SomaDebuggerGCEvent(SomaDebuggerGCEvent.ADD_WATCHER, "my sprite", mySprite));

You can dispatch this event from anywhere in an DisplayObject in the display list (Sprite, MovieClip, etc), from the document class, the stage or the SomaCore instance.

In the debugger window, there is a "garbage collection bar" where you can click to see the registered objects, they can be either "retained" or "released". A released object means it has been garbage collected and doesn't exist anymore. The memory used by this object will be free to use.

A "force" button will trigger the garbage collection, it will call System.gc() twice with a small interval. This should only works in a Flash Player Debugger version, but useful for debugging.

Here is a list of events you can use for the garbage collection monitor:

Actionscript:
  1. SomaDebuggerGCEvent.REMOVE_ALL_WATCHERS
  2. SomaDebuggerGCEvent.REMOVE_WATCHER // pass the name of he object as parameter
  3. SomaDebuggerGCEvent.ADD_WATCHER // pass the name of the objects and the object itself as parameter
  4. SomaDebuggerGCEvent.FORCE_GC

Note: by default SomaDebugger is now using a weak reference to the objects that you want to inspect. You can turn off this option to inspect everything in the debugger, but the objects will never be released, making the garbage collection monitor useless.

Here is how to force the inspection of any objects:

Actionscript:
  1. SomaDebugger.WEAK_REFERENCE = false;

Any feedback appreciated!

Romu

Vote in HexoSearch

Comments 3 Comments »