Add LowMemoryNotification to the API on Android platform....

include/v8.h

 // Copyright 2007-2008 the V8 project authors. All rights reserved.
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions are
 // met:
 //
 //     * Redistributions of source code must retain the above copyright
 //       notice, this list of conditions and the following disclaimer.
 //     * Redistributions in binary form must reproduce the above
 //       copyright notice, this list of conditions and the following
 //       disclaimer in the documentation and/or other materials provided
@@ skipping 2225 matching lines @@
   static bool Dispose();
 
 
   /**
    * Optional notification that the embedder is idle.
    * V8 uses the notification to reduce memory footprint.
    * \param is_high_priority tells whether the embedder is high priority.
    */
   static void IdleNotification(bool is_high_priority);
 
+#if defined(ANDROID)

[Mads Ager (chromium), 2009/08/19 17:24:23]

I don't think we need to hide this under #if defined(ANDROID). I think the
method makes sense on other platforms as well.

It should be entirely up to V8 what to do when we get this notification, so the
documentation should be more abstract.  Something along the lines of:

"Optional notification that the system is running low on memory.  V8 uses these
notifications to attempt to free memory."

Then the implementation can contain the #if defined(ANDROID) and do a full GC on
the Android platform and do nothing on the other platforms for now.

[Feng Qian, 2009/08/20 00:06:08]

Done.

+  /**
+   * Android systems sends the browser a notification when it is in low
+   * memory condition. It is necessary to do a full compact GC to release
+   * DOM objects and also uncommit pages.
+   */
+  static void LowMemoryNotification();
+#endif
+
  private:
   V8();
 
   static void** GlobalizeReference(void** handle);
   static void DisposeGlobal(void** global_handle);
   static void MakeWeak(void** global_handle, void* data, WeakReferenceCallback);
   static void ClearWeak(void** global_handle);
   static bool IsGlobalNearDeath(void** global_handle);
   static bool IsGlobalWeak(void** global_handle);
 
@@ skipping 472 matching lines @@
 
 }  // namespace v8
 
 
 #undef V8EXPORT
 #undef V8EXPORT_INLINE
 #undef TYPE_CHECK
 
 
 #endif  // V8_H_