Cocos2d-x 3.x内存管理机制

class CC_DLL Ref
｛
public:
    /**
    * 获取对象的所有权
    * 增加对象的引用计数
    */
    void retain();
    /**
    * 立即释放对象的所有权
    * 减少对象的引用计数，当对象引用计数减为0时，直接销毁对象
    */
    void release();
    /**
    * 自动释放对象的所有权
    * 将对象添加到自动释放池，并且减少对象的引用计数，当对象引用计数减为0时，直接销毁对象
    */
    Ref* autorelease();
    /**
    * 获取当前对象的引用计数
    * 对象被创建时引用计数为1（构造函数初始化_referenceCount为1）
    */
    unsigned int getReferenceCount() const;
protected:
    Ref();
public:
    virtual ~Ref();
protected:
    unsigned int _referenceCount;  // 引用计数
    friend class AutoreleasePool;
public:
    unsigned int _ID;
    int         _luaID;
｝;

void Ref::release()
｛
   CCASSERT(_referenceCount > 0, "reference count should be greaterthan 0");
    --_referenceCount;
    if (_referenceCount == 0)
    ｛
#if defined(COCOS2D_DEBUG) &&(COCOS2D_DEBUG > 0)
       auto poolManager = PoolManager::getInstance();
       if (!poolManager->getCurrentPool()->isClearing() && poolManager->isObjectInPools(this))
       ｛
           // 这里是非常重要的一点，在我们使用Cocos2d-x中经常出错的地方
           // 当引用计数为0，同时这个对象还存在于autorelease池中的时候，就会出现一个断言错误
           // 可以想到，当这个对象引用计数为0时，就表示需要释放掉，如果它还在autorelease池中，
           // 当在autorelease池中再次被释放时，就会出现错误，这种错误是不了解Cocos2d-x内存管理的
           // 编程人员经常犯的错误。
           //
           // 出现这个错误的原因在于new/retain和autorelease/release没有对应使用引起的
           CCASSERT(false, "The reference shouldn't be 0 because it is still in autoreleasepool.");
       ｝
#endif
    ｝
｝

auto obj= Node::create();// 引用计数为1，autorelease对象，已经被加入自动释放池

obj->autorelease();//WRONG!!! 企图再次将obj加入自动释放池。Ifyou wish to invoke autorelease several times, you should retain `obj` first.

autoobj = Node::create();

obj->release();   // WRONG!!! obj is an autorelease Ref, itwill be released when clearing current pool.

autoobj = Node::create();

|- new Node();     // `new` is the pair of the `autorelease`of next line

|- autorelease();  // The pair of `new Node`.

obj->retain();

obj->autorelease();  // This `autorelease` is the pair of `retain`。

autoobj = Node::create();

obj->retain();

obj->release();   // This `release` is the pair of `retain` ofprevious line.

#define CREATE_FUNC(__TYPE__) \
static __TYPE__* create() \
｛ \
   __TYPE__ *pRet = new__TYPE__(); \
   if (pRet && pRet->init())\
    ｛\
       pRet->autorelease(); \
       return pRet; \
    ｝\
   else \
    ｛\
       delete pRet; \
       pRet = NULL; \
       return NULL; \
    ｝\
｝

class CC_DLL AutoreleasePool
｛
public:
    /**
     * 不能在堆上创建一个自动释放对象，在栈上创建
     * 在栈上创建自动释放对象决定了该对象会被自动释放
     */
    AutoreleasePool();
    /**
     * 创建一个带有指定名字的autorelease pool对象，这个名字对调试非常有用
     */
    AutoreleasePool(const std::string &name);
    ~AutoreleasePool();
    /**
     * 将指定的`自动释放对象`加入自动释放池
     * 同一对象可能加入到自动释放池中很多次（不过会断言错误啊）
     * 当自动释放池销毁时，它会调用同样次数的`Ref::release()` 来销毁对象
     */
    void addObject(Ref *object);
     /**
    * 清理自动释放池
    * 依次调用自动释放池中对象的release()函数
    */
    void clear();
#if defined(COCOS2D_DEBUG) && (COCOS2D_DEBUG> 0)
    /**
     * 判断是否正在对自动释放池执行清理操作
     */
    bool isClearing() const ｛ return _isClearing; ｝;
#endif
    /**
     *判断自动释放池是否包含指定的Ref对象
     */
    bool contains(Ref* object) const;
    /**
     * 打印autorelease pool中所有的对象
     */
    void dump();
private:
    /**
     *所有对象都是使用std::vector存放
     * 即自动释放池维护了一个std::vector容器，它是用于存放自动对象的数据结构
     */
    std::vector<Ref*> _managedObjectArray;
    std::string _name;
#if defined(COCOS2D_DEBUG) &&(COCOS2D_DEBUG > 0)
    /**
     *  Theflag for checking whether the pool is doing `clear` operation.
     */
    bool _isClearing;
#endif
｝;

AutoreleasePool::AutoreleasePool()
: _name("")
#if defined(COCOS2D_DEBUG) &&(COCOS2D_DEBUG > 0)
, _isClearing(false)
#endif
｛
    _managedObjectArray.reserve(150);
    PoolManager::getInstance()->push(this);
｝
AutoreleasePool::AutoreleasePool(const std::string &name)
: _name(name)
#if defined(COCOS2D_DEBUG) && (COCOS2D_DEBUG> 0)
, _isClearing(false)
#endif
｛
    _managedObjectArray.reserve(150);
    PoolManager::getInstance()->push(this);
｝
AutoreleasePool::~AutoreleasePool()
｛
    CCLOGINFO("deallocing AutoreleasePool: %p", this);
    clear();
    PoolManager::getInstance()->pop();
｝
既然发现了为何要这么设计，那么下面来学习PoolManager头文件的声明：
class CC_DLL PoolManager
｛
public:
    CC_DEPRECATED_ATTRIBUTEstatic PoolManager* sharedPoolManager() ｛ return getInstance(); ｝
    static PoolManager* getInstance();
    CC_DEPRECATED_ATTRIBUTEstatic void purgePoolManager() ｛ destroyInstance(); ｝
    static void destroyInstance();
    /**
     *Get current auto release pool, there is at least one auto release pool thatcreated by engine.
     *You can create your own auto release pool at demand, which will be put intoauto release pool stack.
     */
    AutoreleasePool*getCurrentPool() const;
    bool isObjectInPools(Ref* obj) const;
    friend class AutoreleasePool;
private:
    PoolManager();
    ~PoolManager();
    void push(AutoreleasePool *pool);
    void pop();
    static PoolManager* s_singleInstance;
    std::vector<AutoreleasePool*> _releasePoolStack;
｝;