复杂Android项目的适配BugFIX(不用Merge)

.gitignore

@@ -2,6 +2,10 @@
 *.apk
 *.ap_
 
+gradle/
+gradlew
+gradlew.bat
+
 # Files for the Dalvik VM
 *.dex
 

README.md

@@ -1,143 +1,127 @@
-*Android SDK sucks. It's so slow to build and run which waste me a lot of time every day.*
-
-## Motivation
-
-Facebook Buck <http://github.com/facebook/buck> build is fast. However, the biggest problem with Buck is, it requires you to change a lot of codes, and restructs your project in small modules. Indeed, it is troublesome to just make it work properly on the existing android project, especially if you have big project. I have tried using Buck build system instead of Gradle on my test project. However, it took me a week just to make it work.
-
-What I needs is a build tool that is easy to setup, fast as Buck, and provide a Run button in Android Studio. So I created LayoutCast.
-
-**LayoutCast** is a little tool to help with that, it will cast every changes in your Java source code or resources (including library project) to your phone or emulator within 5 sec, and does not restart your application.
-
-把代码和资源文件的改动直接同步到手机上，应用不需要重启。省去了编译运行漫长的等待，比较适合真机调试的时候使用。
-
-![GIF](images/cast_res.gif)
-![GIF](images/cast_code.gif)
-
-Youtube demo video: <https://youtu.be/rc04LK2_suU>
-
-优酷: <http://v.youku.com/v_show/id_XMTMwNTUzOTQ3Mg>
-
-## Features
-
-- Fast cast code and resource changes, usually less than 5 sec.
-- Cast does not reset your application. The running activity stack will be kept.
-- Easy to setup, only add few lines of code.
-- Support both eclipse and AndroidStudio project.
-- Provide a AndroidStudio plugin to click and cast.
-
-## Limitations
-
-- ~~LayoutCast only support Mac (for now)~~
-- Cast Java code only support ART runtime (Android 5.0)
-
-## Benchmarks
-
-Here is how it compared to Gradle and Facebook Buck:
-
-![BENCHMARK](images/benchmark1.png)
-
-The test machine is a 2015 MBP with a 2014 MotoX.
-
-The test project's apk is about 14.3MB, which contains 380k lines of java code and 86k lines of xml files.
-
-## Getting Started for Android Studio / Intellij
-
-### 1. Install Plugin
-
-*If you have already done that, you can skip this step.*
-
-1. Download Android Studio / Intellij plugin <https://github.com/mmin18/LayoutCast/raw/master/ide/IDEAPlugin/IDEAPlugin.jar>
-2. In Android Studio, go to `Preferences` > `Plugins` > `Install plugin from disk...`
-3. Choose the downloaded file from step #1 to install the plugin.
-
-After restart, you should find a button at right of the run section: ![TOOLBAR](images/sc_toolbar.png)
-
-### 2. Android Project & Build System Changes
-
-**First,** you need to setup your project. Add below dependency in your build.gradle:
-
+# LayoutCast
+是什么东西，工作原理见最后面！
+
+## 1. 特色
+* Fast cast code and resource changes, usually less than 5 sec.
+	* `快速处理代码和Resource的变化，5s内生效`
+* Cast does not reset your application. The running activity stack will be kept.
+	* `保留当前的Activity Stack`, 一般情况下只更新当前的Activity
+* Easy to setup, only add few lines of code.
+	* `容易使用`
+* Support both eclipse and AndroidStudio project.
+	* `其实基本和IDE无关`，只是用到了IDE的某个目录结构的特点
+* Provide a AndroidStudio plugin to click and cast.
+	* 要求 `adb devices` 只有一个设备, 否则plugin就傻了，不过也不影响开发
+
+
+## 2. 如何和Android Studio集成呢?
+
+* Android Project & Build System Changes
+	* 添加依赖
+```gradle
 	dependencies {
 		compile 'com.github.mmin18.layoutcast:library:1.+@aar'
 		...
 	}
+```
+
+	* 修改Application的代码
+```java
+public class MyApplication extends Application {
+    @Override
+    public void onCreate() {
+        super.onCreate();
+
+		// 只在测试时有效
+        if (BuildConfig.DEBUG) {
+            LayoutCast.init(this);
+        }
+    }
+}
+```
+	* 修改AndroidManifest.xml
+```xml
+    <application
+        android:name=".MyApplication"
+		...
 
-**Second,** add the following code in your main application class inside `onCreate()` method. And since LayoutCast only necessary when you develop, you should always check if `BuildConfig.DEBUG == true`.
+	<activity android:name="com.github.mmin18.layoutcast.ResetActivity" />
+    <uses-permission android:name="android.permission.INTERNET" />
+```
 
-	public class MyApplication extends Application {
-		@Override
-		public void onCreate() {
-			super.onCreate();
+* 运行
+	* 正常运行Android项目
+	* 修改资源或者Java代码, 然后: `./cast.py` （`不建议安装Android Studio插件`，用起来不爽)
+```bash
+	cd <project path> 或项目root目录
+	python cast.py
+    python cast.py --device=xxxx
 
-			if (BuildConfig.DEBUG) {
-				LayoutCast.init(this);
-			}
-		}
-	}
+	Or you can specify the path in args:
+	python cast.py <project path>
+```
 
-**Thrid,** don't forget to check if your Application class is registered in `AndroidManifest.xml`:
 
-    <application
-        android:name=".MyApplication"
-		...
 
-**Fourth,** add special activity class (from LayoutCast library) called `ResetActivity` in your manifest, this activity will be used to restart and restore our application activity stack.
 
-	<activity android:name="com.github.mmin18.layoutcast.ResetActivity" />
+## Troubleshootings(一定要看)
+* `这只是一个工具，保证能用，但是不保证任何场合都能用`（理论上OK, 但是没有经过完整测试）
+* 目录结构的约定:
+	* It can only find `/src` folder under `<project>/src` or `<project>/src/main/java`
+	* It can only find `/res` folder under `<project>/res` or `<project>/src/main/res`
+* 可以添加和修改资源，但是不能删除
+	* You can add or replace resources, but you can't delete or rename resources (for now)
+	* 删除之后重新使用gradle`编译运行即可`, 也就是放弃gradle的状态
+* 异常如何处理:
+	* If cast failed, clean your project, remove `/bin` and `/build` and rebuild again may solve the problem
 
-And make sure you have the network permission in your `AndroidManifest.xml`:
+-----
 
-    <uses-permission android:name="android.permission.INTERNET" />
+## How it Works
 
-### 3. Run and cast
+When **LayoutCast.init(context);** called, the application will start tiny http server in the background, and receive certain commands. Later on, the cast script running on your computer will communicate with your running app which is running through ADB TCP forward.
 
-Run the application (in device or emulator), then try to make some changes for resources file or java file.
+When the cast script runs, it will scan all possible ports on your phone to find the running LayoutCast server, and get the running application's resource list with its id, then compiled to `public.xml`. In which, it will be used later to keep resource id index consistent with the running application.
 
-After that, click the LayoutCast button in toolbar (on the right of Run button) / go to menu `Tools`> `Layout Cast`.
+The cast script scans your project folder to find the `/res` folder, and all dependencies inside `/res` folder. You can run the **aapt** command to package all resources into **res.zip**, and then upload the zip file to the LayoutCast server to replace the resources of the running process. Then, it calls the **Activity.recreate()** to restart the visible activity.
 
-It will show the result above status bar:
+Usually the activity will keep its running state in **onSaveInstanceState()** and restore after coming back later.
 
-![SUCCESS](images/sc_success.png)
 
-![FAIL](images/sc_fail.png)
 
-## Getting started for Eclipse
+`Android SDK sucks. It's so slow to build and run which waste me a lot of time every day.`
 
-### 1. Prepare the cast script
+## Motivation
 
-I haven't written the Eclipse plugin yet, so if you need to use it on a eclipse project, you can try to use the command line.
+Facebook Buck <http://github.com/facebook/buck> build is fast. However, the biggest problem with Buck is, it requires you to change a lot of codes, and restructs your project in small modules. Indeed, it is troublesome to just make it work properly on the existing android project, especially if you have big project. I have tried using Buck build system instead of Gradle on my test project. However, it took me a week just to make it work.
 
-You can get the script here <https://raw.githubusercontent.com/mmin18/LayoutCast/master/cast.py>. Put the script in project root dir or anywhere you like. Since it is written in Python 2.7 (make sure you have installed the right version). 
+What I needs is a build tool that is easy to setup, fast as Buck, and provide a Run button in Android Studio. So I created LayoutCast.
 
-### 2. Android Project & Build System Changes
+**LayoutCast** is a little tool to help with that, it will cast every changes in your Java source code or resources (including library project) to your phone or emulator within 5 sec, and does not restart your application.
 
-To get it work, we will need to download the LayoutCast library <https://github.com/mmin18/LayoutCast/raw/master/libs/lcast.jar> and put it to your `/libs` folder.
+把代码和资源文件的改动直接同步到手机上，应用不需要重启。省去了编译运行漫长的等待，比较适合真机调试的时候使用。
 
-The project structure will remain the same.
+![GIF](images/cast_res.gif)
+![GIF](images/cast_code.gif)
 
-### 3. Run and Cast
+Youtube demo video: <https://youtu.be/rc04LK2_suU>
 
-Run the application first, and open terminal and execute **python cast.py** under your project's folder:
+优酷: <http://v.youku.com/v_show/id_XMTMwNTUzOTQ3Mg>
 
-	cd <project path>
-	python cast.py
 
-Or you can specify the path in args:
+## Limitations
 
-	python cast.py <project path>
+- ~~LayoutCast only support Mac (for now)~~
+- Cast Java code only support ART runtime (Android 5.0)
 
-## How it Works
+## Benchmarks
 
-When **LayoutCast.init(context);** called, the application will start tiny http server in the background, and receive certain commands. Later on, the cast script running on your computer will communicate with your running app which is running through ADB TCP forward.
+Here is how it compared to Gradle and Facebook Buck:
 
-When the cast script runs, it will scan all possible ports on your phone to find the running LayoutCast server, and get the running application's resource list with its id, then compiled to `public.xml`. In which, it will be used later to keep resource id index consistent with the running application.
+![BENCHMARK](images/benchmark1.png)
 
-The cast script scans your project folder to find the `/res` folder, and all dependencies inside `/res` folder. You can run the **aapt** command to package all resources into **res.zip**, and then upload the zip file to the LayoutCast server to replace the resources of the running process. Then, it calls the **Activity.recreate()** to restart the visible activity.
+The test machine is a 2015 MBP with a 2014 MotoX.
 
-Usually the activity will keep its running state in **onSaveInstanceState()** and restore after coming back later.
+The test project's apk is about 14.3MB, which contains 380k lines of java code and 86k lines of xml files.
 
-## Troubleshootings
 
-- It can only find `/src` folder under `<project>/src` or `<project>/src/main/java`
-- It can only find `/res` folder under `<project>/res` or `<project>/src/main/res`
-- You can add or replace resources, but you can't delete or rename resources (for now)
-- If cast failed, clean your project, remove `/bin` and `/build` and rebuild again may solve the problem

build.gradle

@@ -1,7 +1,18 @@
 buildscript {
     repositories {
+        mavenCentral()
+        maven {
+            url "http://maven.chunyu.mobi/content/groups/public/"
+            credentials {
+                username maven_user
+                password maven_password
+            }
+        }
+
         jcenter()
     }
+
+
     dependencies {
         classpath 'com.android.tools.build:gradle:1.2.3'
         classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
@@ -11,6 +22,14 @@ buildscript {
 
 allprojects {
     repositories {
+        mavenCentral()
+        maven {
+            url "http://maven.chunyu.mobi/content/groups/public/"
+            credentials {
+                username maven_user
+                password maven_password
+            }
+        }
         jcenter()
     }
 }