Remove Android原生接入部分， 改为跳转官网接入

梁登科 · 梁登科 · commit b375c8d4dc11 · 2018-11-06T17:42:57.000+08:00
diff --git a/README.md b/README.md
@@ -6,108 +6,77 @@ GrowingIO的埋点版本flutter插件.
 
 # 一: 集成
 ## 1. Flutter插件获取安装
-根据[dart pub](https://pub.dartlang.org/packages/flutter_growingio_track#-installing-tab-) 文档获取安装
+根据[dart pub](https://pub.dartlang.org/packages/flutter_growingio_track#-installing-tab-)文档获取安装
 
 ## 2. Android集成(Native部分)
+此Flutter插件运行在Android手机上时依赖于GrowingIO Android SDK(可以是无埋点SDK也可以是埋点SDK)2.6.0及以上, 原生部分请参考[Android官方文档集成SDK部分(无埋点)](https://docs.growingio.com/docs/sdk-integration/android-sdk/#ji-cheng-sdk) 或 [Android官方文档集成SDK部分(埋点)](https://docs.growingio.com/docs/sdk-integration/android-sdk/android-maidian-sdk)接入集成. 
 
-此Flutter插件可支持track版本与auto-track版本的GrowingIO SDK使用, 请根据需要自行选择搭配
-
-### 1.1 添加Android依赖
-#### 依赖纯打点版本
-纯打点版本(track)版本， 需要依赖track版本的SDK
-
-    dependencies{
-        implementation 'com.growingio.android:vds-android-agent:track-2.6.0'
-    }
-
-### 1.2 无埋点版本
-无埋点版本(auto-track)版本， 需要依赖于auto-track版本的SDK并且需要配置Gradle插件
-
-*配置ClassPath:*
-
-    buildscript {
-        repositories {
-            jcenter()
-            google()
-        }
-        dependencies {
-            //gradle建议版本
-            classpath 'com.android.tools.build:gradle:3.1.3'
-            classpath 'com.growingio.android:vds-gradle-plugin:autotrack-2.6.0'
-        }
-    }
-
-*使用插件:*
-
-    apply plugin: 'com.android.application'
-    //添加插件
-    apply plugin: 'com.growingio.android'
-    ​
-    dependencies {
-            compile 'com.growingio.android:vds-android-agent:autotrack-2.6.0@aar'
-    }
-
-### 2. 获取projectId与UrlScheme
-
-在GrowingIO官网应用管理创建Android应用， 跳转界面后可以发现包含projectId与UrlSchema的代码片段， 请粘贴到项目对应位置: 
-
-    android {
-      defaultConfig {
-    	// xxxx
-    	resValue("string", "growingio_project_id", "9926fc6c1189e2fb")
-    	resValue("string", "growingio_url_scheme", "growing.da7e6c2879469314")
-    	// xxxx
-      }
-    }
-
-另外为了可以从浏览器直接跳转App， 需要在Manifest中配置UrlSchema
-
-    <intent-filter>
-      <data android:scheme="growing.da7e6c2879469314"/>
-      <action android:name="android.intent.action.VIEW" />
-    
-      <category android:name="android.intent.category.DEFAULT" />
-      <category android:name="android.intent.category.BROWSABLE" />
-    </intent-filter>
-
-同时也需要配置权限（比如网络权限）
-
-    <uses-permission android:name="android.permission.INTERNET" />
-    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
-    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
-
-具体配置请参见项目的example配置
-
-
-### 3. 初始化SDK
-
-GrowingIO的SDK需要在Application的onCreate中初始化: 
-
-    GrowingIO.startWithConfiguration( this,
-    		new Configuration()
-    				.setChannel("渠道名")
-    				.setRnMode(true)     // 这个必须设置
-    				.setDebugMode(true)   // 显示日志， release环境请关闭
-    				.setTestMode(true));  // 即时发送， release环境请关闭
-
-如果flutter项目没有自定义Application， 需要用户自己手动添加一个AndroidApplication， 可参照example
-
-
-### 4. tip
-
-1.  为什么Android项目里面高亮GrowingIO的类会出现报红色
-
-    这个应该是Flutter项目结构问题，不过并不影响运行， 可以放心编译
-
-2.  为什么不在flutter中初始化:
-
-    -   因为GrowingIO需要获取Android的Activity生命周期， 为了数据的准确性， 需要在Activity出现前就初始化完成
-    -   开发者相信很多用户都会使用flutter + native形式的进行开发， 为了同时服务flutter于native
-
-
+可以参考仓库中的example项目. 
 
 ## 3. iOS集成(Native部分) 
-集成方式见Word文档：Flutter-iOS集成文档
+### 3.1 选择集成方式
+### 3.2 设置URL Scheme
+#### 3.2.1 获取URL Scheme
+- 添加新产品：登录官网 -> 点击项目选择框 -> 点击“项目管理” -> 点击“应用管理” -> 点击“新建应用”->选择添加 iOS 应用 -> 填写“应用名称“，点击下一步 ->在第二段中标黄字体。
+- 现有产品：登录官网 -> 点击项目选择框 -> 点击“项目管理” -> 点击“应用管理” -> 找到对应产品的 URL Scheme
+
+#### 3.2.2 添加 URL Scheme（growing.xxxxxxxxxxxxxxxx）到项目中
+#### 3.2.3 添加依赖, 在项目中添加以下库文件：
+
+| 库名称                        | 类型                                      |
+| -----                         | ------                                    |
+| Foundation.framework          | 基础依赖库                                |
+| Security.framework            | 用于SSL连接                               |
+| CoreTelephony.framework       | 用于读取运营商名称                        |
+| SystemConfiguration.framework | 用于判断网络状态                          |
+| AdSupport.framework           | 用于来源管理激活匹配                      |
+| libicucore.tbd                | 用于WebSocket                             |
+| ibsqlite3.tbd                 | 存储日志                                  |
+| CoreLocation.framework        | 用于读取地理位置信息（如果您的app有权限） |
+	
+添加完成以后, 库的引用如下: 提醒:
+
+(optional) GrowingIO推荐您添加AdSupport.framework依赖库,用于来源管理激活匹配,有利于您更好的分析的数据
+- 添加项目依赖库的位置在项目设置target -> 选项卡General -> Linked Frameworks and Libraries
+
+#### 3.2.4 添加编译参数
+略
+
+### 3.3 初始化SDK
+在 AppDelegate 中引入#import "Growing.h"并添加启动方法
+
+	#import "Growing.h"
+	- (BOOL)application:(UIApplication *)application
+    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
+      ...
+      // 启动GrowingIO
+      [Growing startWithAccountId:@"xxxxxxxxxxxxxxxx"]; //替换为您的ID
+      // 其他配置
+      // 开启Growing调试日志 可以开启日志
+      // [Growing setEnableLog:YES];
+	}
+
+请确保将代码添加在上面描述的位置，添加到其他函数中或者异步 block 中可能导致数据不准确！
+
+至此，您的SDK安装就成功了。登录 GrowingIO 进入产品安装页面执行“数据检测”，几分钟后就可以看到数据了。
+
+## 4. Tips
+#### 4.1 IOS: App Store 提交应用
+如果您添加了库AdSupport.framework, GrowingIO则会启用 IDFA，所以在向 App Store 提交应用时，需要：
+- 对于问题 Does this app use the Advertising Identifier (IDFA)，选择 YES。
+- 对于选项Attribute this app installation to a previously served advertisement，打勾。
+- 对于选项Attribute an action taken within this app to a previously served advertisement，打勾。
+
+#### 4.2 IOS: 为什么 GrowingIO使用IDFA
+GrowingIO 使用 IDFA 来做来源管理激活设备的精确匹配，让你更好的衡量广告效果。如果你不希望跟踪这个信息，可以选择不引入 AdSupport.framework
+
+#### 4.3 Android: 初始化Android SDK时, GrowingIO类可能会报红色
+这个应该是Flutter项目结构的问题， 并不影响运行， 可以放心编译. 不过需要手动import-_-|
+
+#### 4.4 为什么不在flutter中单独初始化
+-  因为GrowingIO需要获取Android的Activity生命周期， 为了数据的准确性， 需要在Activity出现前就初始化完成
+-  开发者相信很多用户都会使用flutter + native形式的进行开发， 为了同时服务flutter于native
+
 
 # 二: API
 
@@ -119,11 +88,11 @@ GrowingIO的SDK需要在Application的onCreate中初始化:
 
 1.  track发送自定义事件, 对应于cstm事件
 
-      | 参数     | 是否必填 | 说明           |
-      |----------|----------|----------------|
-      | eventId  | 是       | 事件Id         |
-      | num      | 否       | 数值, double型 |
-      | variable | 否       | 变量, Map型          |
+       | 参数     | 是否必填 | 说明           |
+       |----------|----------|----------------|
+       | eventId  | 是       | 事件Id         |
+       | num      | 否       | 数值, double型 |
+       | variable | 否       | 变量, Map型          |
     
     调用示例:
     
@@ -155,9 +124,9 @@ GrowingIO的SDK需要在Application的onCreate中初始化:
 
 4.  setUserId设置登录用户Id, 对应于cs1字段
 
-    | 参数   | 类型   | 描述       |
-    | -----  | ------ | -----      |
-    | userId | String | 登录用户Id |
+      | 参数   | 类型   | 描述       |
+      | -----  | ------ | -----      |
+      | userId | String | 登录用户Id |
 
     函数原型: setUserId(String userId)
     
diff --git a/flutter_growingio_track.iml b/flutter_growingio_track.iml
@@ -15,6 +15,5 @@
     <orderEntry type="sourceFolder" forTests="false" />
     <orderEntry type="library" name="Dart SDK" level="project" />
     <orderEntry type="library" name="Flutter Plugins" level="project" />
-    <orderEntry type="library" name="Dart Packages" level="project" />
   </component>
 </module>
diff --git a/lib/flutter_growingio_track.dart b/lib/flutter_growingio_track.dart
@@ -6,35 +6,35 @@ class GrowingIO {
   static const MethodChannel _channel =
       const MethodChannel('flutter_growingio_track');
 
-
-  static Future<Null> track(String eventId, {double num, Map<String, dynamic> variable}) async{
+  static Future<Null> track(String eventId,
+      {double num, Map<String, dynamic> variable}) async {
     Map<String, dynamic> args = {"eventId": eventId};
-    if(num != null){
+    if (num != null) {
       args['num'] = num;
     }
-    if(variable != null){
+    if (variable != null) {
       args['variable'] = variable;
     }
     return await _channel.invokeMethod("track", args);
   }
 
-  static Future<Null> setEvar(Map<String, dynamic> variable) async{
+  static Future<Null> setEvar(Map<String, dynamic> variable) async {
     return await _channel.invokeMethod("setEvar", variable);
   }
 
-  static Future<Null> setPeopleVariable(Map<String, dynamic> variable) async{
+  static Future<Null> setPeopleVariable(Map<String, dynamic> variable) async {
     return await _channel.invokeMethod("setPeopleVariable", variable);
   }
 
-  static Future<Null> setUserId(String userId) async{
+  static Future<Null> setUserId(String userId) async {
     return await _channel.invokeMethod("setUserId", {"userId": userId});
   }
 
-  static Future<Null> clearUserId() async{
+  static Future<Null> clearUserId() async {
     return await _channel.invokeMethod("clearUserId");
   }
 
-  static Future<Null> setVisitor(Map<String, dynamic> variable) async{
+  static Future<Null> setVisitor(Map<String, dynamic> variable) async {
     return await _channel.invokeMethod("setVisitor", variable);
   }
 }
diff --git a/pubspec.yaml b/pubspec.yaml
@@ -1,8 +1,8 @@
 name: flutter_growingio_track
-description: Flutter Plugin For GrowingIO track 
-version: 0.0.1
+description: Flutter Plugin For GrowingIO SDK, is used for calling GrowingIO api in flutter. 
+version: 0.0.3
 author: ldk <ldkxingzhe@gmail.com>
-homepage: https://www.growingio.com
+homepage: https://github.com/growingio/flutter-growingio-track
 
 environment:
   sdk: ">=2.0.0-dev.68.0 <3.0.0"

Original file line number	Diff line number	Diff line change
`@@ -6,35 +6,35 @@ class GrowingIO {`
`6`	`6`	`static const MethodChannel _channel =`
`7`	`7`	`const MethodChannel('flutter_growingio_track');`
`8`	`8`
`9`		`-`
`10`		`- static Future<Null> track(String eventId, {double num, Map<String, dynamic> variable}) async{`
	`9`	`+ static Future<Null> track(String eventId,`
	`10`	`+ {double num, Map<String, dynamic> variable}) async {`
`11`	`11`	`Map<String, dynamic> args = {"eventId": eventId};`
`12`		`- if(num != null){`
	`12`	`+ if (num != null) {`
`13`	`13`	`args['num'] = num;`
`14`	`14`	`}`
`15`		`- if(variable != null){`
	`15`	`+ if (variable != null) {`
`16`	`16`	`args['variable'] = variable;`
`17`	`17`	`}`
`18`	`18`	`return await _channel.invokeMethod("track", args);`
`19`	`19`	`}`
`20`	`20`
`21`		`- static Future<Null> setEvar(Map<String, dynamic> variable) async{`
	`21`	`+ static Future<Null> setEvar(Map<String, dynamic> variable) async {`
`22`	`22`	`return await _channel.invokeMethod("setEvar", variable);`
`23`	`23`	`}`
`24`	`24`
`25`		`- static Future<Null> setPeopleVariable(Map<String, dynamic> variable) async{`
	`25`	`+ static Future<Null> setPeopleVariable(Map<String, dynamic> variable) async {`
`26`	`26`	`return await _channel.invokeMethod("setPeopleVariable", variable);`
`27`	`27`	`}`
`28`	`28`
`29`		`- static Future<Null> setUserId(String userId) async{`
	`29`	`+ static Future<Null> setUserId(String userId) async {`
`30`	`30`	`return await _channel.invokeMethod("setUserId", {"userId": userId});`
`31`	`31`	`}`
`32`	`32`
`33`		`- static Future<Null> clearUserId() async{`
	`33`	`+ static Future<Null> clearUserId() async {`
`34`	`34`	`return await _channel.invokeMethod("clearUserId");`
`35`	`35`	`}`
`36`	`36`
`37`		`- static Future<Null> setVisitor(Map<String, dynamic> variable) async{`
	`37`	`+ static Future<Null> setVisitor(Map<String, dynamic> variable) async {`
`38`	`38`	`return await _channel.invokeMethod("setVisitor", variable);`
`39`	`39`	`}`
`40`	`40`	`}`