Lee2011/weex-quick-start

Weex-Quick-Start

该项目为Weex的Quick-Start项目，使用过程中如果有更好的样例或者，能把代码解释得更详细的，更清楚的，欢迎提PR，我会尽量merge的^-^. 请先进入下载页下载最新的apk在自己的手机上试试，不行的话，手机兼容可能有点问题，可以的话，就可以大胆尝试了。

环境说明

IDE: Android Studio 2.2.1
System: Windows 10, 64 bit.
Gradle: 2.14.1
命令日志详情

git clone https://github.com/zhoukekestar/weex-quick-start
cd weex-quick-start
gradle build  
// 因为我没有配置gradle命令的路径，所以，实际命令是 "C:\Program Files\Android\Android Studio\gradle\gradle-2.14.1\bin\gradle" build
// 生成的apk在app\build\outputs\apk目录下
// 你也可以直接使用android studio打开该文件夹进行编译

20161021更新笔记

终于修复了64位机器的问题，是由于引入一个facebook的包引起的，也是郁闷。。。
你可以进入下载页下载最新的apk在自己的手机上试试

20161019更新笔记

由于小米note3是64的机器，导致出现java.lang.UnsatisfiedLinkError: dlopen failed: "/data/data/com.github.zhoukekestar.weexquickstart/files/libweexcorebk1.so" is 32-bit instead of 64-bit错误，纠结了好几天。。。换成32位的机器就行了
launchInspector HackAssertionException com.taobao.weex.utils.WXHack$HackDeclaration$HackAssertionException: java.lang.ClassNotFoundException: com.taobao.weex.devtools.debug.DebugServerProxy 该错误不影响页面的基础显示
[WXBridgeManager] invokeCallJSBatch: framework.js uninitialized.该错误不影响页面基础展示
gradle构建的maven镜像使用了阿里云的maven镜像库进行了加速：maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }（国外的实在太慢了）
推荐使用方式3引入SDK，如: compile 'com.taobao.android:weex_sdk:0.8.0.1，该方式最为简单
该QuickStart项目将以最小可运行、最基础样例代码为目的
为了节约你的测试成本，你先可以安装该项目生成的apk，能成功运行说明代码在你手机上没问题，下载代码愉快地开始使用weex吧，不能的话，估计。。。还得继续踩坑

app/libs，复制libs

app/libs下有inspector-[debug/release].aar,weex_debug-[debug/release].aar,weex_sdk-[debug/release].aar等6个文件

所有的文件都可以从weex项目下build文件夹下找到（当然需要之前编译过才行）参考文章

比如：以我当前电脑环境为例，我的weex项目clone在D:\Temp-Doc\weex\weex-repo目录下。

所以在运行过playground后，可以在D:\Temp-Doc\weex\weex-repo\android\sdk\build\outputs\aar找到weex_sdk-[debug/release].aar

ps: 不想运行playground的同学，可以直接clone当前项目，在当前项目app/libs下有上传aar文件

MainApplication.class

初始化SDKEngine

public class MainApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        WXEnvironment.addCustomOptions("appName", "QuickStart");
        WXSDKEngine.initialize(this, null);

        WXSDKEngine.setIWXImgLoaderAdapter(new ImageAdapter());

    }
}

写完后，别忘了在AndroidManifest.xml设置application的name属性

<application
    android:name=".MainApplication"
    ...

MainActivity.class

大部分代码直接看吧，主要是下面几句，将assets中的index.js（这个是.we文件编译后的js文件）作为template，并渲染

String template = WXFileUtils.loadFileContent("index.js", this);
mInstance.render("pagenmae", template, null, null, -1, -1, WXRenderStrategy.APPEND_ASYNC);

AndroidManifest.xml

 <uses-permission android:name="android.permission.INTERNET" /> // 各种权限，能写的都写上吧。。。
 <application
       android:name=".MainApplication"
       tools:overrideLibrary="com.taobao.android.dexposed"  // 重写库，需要引入com.taobao.android:dexposed:0.1.8依赖
       android:allowBackup="false"                          // 由于上面的重写，这里需要设置false
       android:icon="@mipmap/ic_launcher"
       android:label="@string/app_name"
       android:supportsRtl="true"
       android:theme="@style/AppTheme">

       <activity android:name=".MainActivity">
           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>

build.gradle

设置libs文件，采用方式1（即自定义aar方式）引入SDK时需要使用，采用其他方式可注释掉

repositories {
    flatDir {
        dirs project(':app').file('libs')
    }
}

引入weex-sdk，我采用了3种方式，自定义aar、以module方式引入sdk目录、官方发布aar

// 方式1：SDK 自定义arr引入（构建playground的时候会在weex\android\sdk\build\outputs\aar\weex_sdk-release.aar）
compile(name:'weex_sdk-release', ext:'aar')

// 方式2：SDK 目录引入
// compile project(':weex_sdk')

// 方式3：SDK 官方发布引入，官方会发布SDK到jcenter
// compile 'com.taobao.android:weex_sdk:0.6.1'

settings.gradle

采用方式2（即引入sdk目录自己构建的时候）引入WEEX_SDK时需要，其他方式可注释掉。。。

include ":weex_sdk"
project(":weex_sdk").projectDir = new File("D:\\Temp-Doc\\weex\\weex-repo\\android\\sdk")
// 采用方式2（即引入sdk目录自己构建的时候）引入WEEX_SDK时需要
// ../weex-repo/android/sdk 目录为 https://github.com/alibaba/weex/tree/dev/android/sdk 在本地的目录

weex开发

weex开发在weex/src目录下
Linux/Mac用户，需执行npm install来安装依赖，之后需要运行npm run build
windows用户，需执行npm install来安装依赖，之后只需双击run.cmd即可
程序会自动检测文件变化并进行实时编译（如果文件添加，需要重新运行）
weex/src目录下开发的weex代码，将通过构建导出到app/src/main/assets/weex

Errors

我刚开始，貌似有个jsframework未初始化的错误

08-13 10:13:49.187 5490-5508/com.github.zhoukekestar.weexquickstart E/weex: [WXBridgeManager] invokeCreateInstance: framework.js uninitialized. // 这边有个错误
08-13 10:13:49.187 5490-5508/com.github.zhoukekestar.weexquickstart D/weex: WXDebugTool not found!
08-13 10:13:49.187 5490-5508/com.github.zhoukekestar.weexquickstart D/weex: WXDebugTool not found!
08-13 10:13:49.187 5490-5508/com.github.zhoukekestar.weexquickstart D/weex: framework from assets
08-13 10:13:49.207 5490-5508/com.github.zhoukekestar.weexquickstart D/weex: WXDebugTool not found!
08-13 10:13:49.217 5490-5508/com.github.zhoukekestar.weexquickstart D/weex: WXDebugTool not found!
08-13 10:13:49.317 5490-5490/com.github.zhoukekestar.weexquickstart D/OpenGLRenderer: Enabling debug mode 0
08-13 10:13:49.347 5490-5490/com.github.zhoukekestar.weexquickstart E/weex: error:createInstance fail! // 错误，然后，无法正常显示

解决方案： Build->Clean Project，然后再次运行，就好了==

Lee2011 / weex-quick-start