[2013.9.8网络首发]导入Android4.2源码里的Gallery2和Camera模块至Eclipse全过程

       [2013.9.8网络首发]导入Android4.2源码里的Gallery2和Camera模块至Eclipse全过程

 

google的android自带的apps写的是相当牛逼的，将其导入到eclipse中方便我们学习扩展。可惜关于导入的资料太少了，尤其是4.1之后的gallery和camera合二为一了。之前导4.0的camera那时不费吹灰之力就搞成了。下面的文字记录是我摸索了近十天终于导成功的记录，给大家分享了。

一、开发环境的搭建

1、      点击http://developer.android.com/sdk/index.html下载adt-bundle-windows-x86-20130522（426M）。尽管部分机子上有非adt-bundle搭建的开发环境，但考虑到google已不支持以往android sdk + adt + Eclipse的方式，改推adt-bundle的方式，故杂家以adt-bundle-windows-x86-20130522搭建的开发环境为基础。（注：这里默认JDK已经安装配置好了。）

2、      点击http://developer.android.com/sdk/installing/installing-adt.html 选择在线或离线方式升级ADT版本为22.0.5。上面的adt-bundle自带的ADT版本是22.0.1，不支持解析rs文件，会导致后面的工作功亏一篑，因此一定要升级。如果在线安装ADT失败，考虑将C:WindowsSystem32driversetchosts文件添加一行：74.125.237.1       dl-ssl.google.com  就可以正常下载安装了，包括后续的更新build-tools、SDK-tools、Platform-tools。具体参考前文

[android开发IDE]adt-bundle-windows-x86的一个bug：无法解析.rs文件--------rs_core.rsh file not found

更新SDK-tools、Platform-tools、build-tools版本分别为22.0.5、18.0.1、18.0.1，

二、导入前的准备

1、      编译Android4.2的源码，目的是为了得到后面的四个classes文件，如果通过其他途径有这四个文件也可以不编译。4.2的源码编译需要在64位机子上。这四个文件稍后会上传到网上。

2、      将F:AndroidSource4.2_r1packagesapps下的Gallery2文件夹和Camera文件夹复制到桌面一份，后续将先导入Gallery2再导入Camera。

3、      在桌面新建一个Camera4.2Need文件夹，将/out/target/commom/obj/JAVA_LIBRARIES/core_intermediates/、/out/target/commom/obj/JAVA_LIBRARIES/framework_intermediates/、/out/target/commom/obj/JAVA_LIBRARIES/mp4parser_intermediates/、/out/target/commom/obj/JAVA_LIBRARIES/ xmp_toolkit_intermediates这四个路径下的classes.jar文件分别重命名为core_intermediates、framework_intermediates、mp4parser_intermediates、xmp_toolkit_intermediates放到Camera4.2Need文件夹，后续这个文件夹可以放到工作空间以免丢失。

三、开始导入

1、      打开eclipse，点击File---New----Project---Android---Android Project from Existing Code,选择桌面的那个Gallery2文件夹，test不要勾选，copy projects到工作空间要勾选。

导入后会报错如下，不用管：

2、      导入后首先检查gen文件夹是否解析了rs文件，正常解析的话会生成ScriptC_convolve3x3.java文件和convolve3x3.d，如果没有生成则说明当前开发环境无法解析rs文件（com.android.gallery3d.filtershow.filters包下的convolve3x3.rs文件），需要重新配置开发环境。

3、      右击工程的属性或按alt+enter快捷键，选中Java Build Path，点击Source，选择Add Folder，将gallerycommon和src_pd勾选上。如果这两个文件夹不勾选，后续会找不到很多类和包，而这些缺失并不是缺少.classes文件导致的。如果提示重复，就按如下步骤进行.

4、      将Android Dependenices文件夹下的那两个空包删除。找到源码Gallery2下的gallerycommon文件夹，需要将这里的文件按对应的包名，添加到gallerycommon文件夹下。新建gallerycommon文件夹，新建包名com.android.gallery3d.common;然后将gallerycommon文件夹下的java文件复制过去。其他的包类似。对源码里的src_pd也做同样的操作。【注：在java build path属性里，source目录下src_pc和gallerycommon这两个文件夹必须勾选，否则新建的包会自动跑到src目录下。】最终得到的结果如下：

[注：这个过程比较灵活，只要最终将两个文件夹下的包导入进去即可，确保包名正确。]

5、      按alt+enter快捷键，选中java build path，点Libraries---Add Library，选择User Library，并将下面的那个选项勾上，表示它的级别很高。New一个Library，名字为Camera4.2Need，将刚准备的四个.jar文件添加进来。

6、      然后点Order and Export，将Camera4.2Need这个库的位置放在Android4.2.2的前面。调整后的顺序如下：

7、      点击res文件夹，点开values文件夹，可以看到里面的filtershow_strings.xml、photoeditor_strings.xml、strings.xml有错误，原因是里面有重复定义。将报错的地方删掉即可！每删掉一个地方，对应的另一个文件报错的地方就会恢复正常。可以按照这种方法对values-xx开头的文件夹都做相同的处理，但事实上，由于我们只要简体中文，所以只保留values-zh-rCN文件夹即可，对此文件夹的报错也作上述处理。其他的values-xx文件夹统统删掉。

8、      在导入camera文件之前需要逐一对照camera下的res文件夹和当前gallery工程下的res文件夹下的文件有无重名。如两者的values文件夹下都有atrrs.xml文件，需要将camera的那一份重命名为atrrs_camera.xml，否则会发生覆盖导致出错。导入时点击Gallery工程，注意一定是导到Gallery工程目录下。右击选择—import---General---File System,其中的.git文件夹及test文件夹、Android.mk、CleanSpec.mk不要选。

9、      点击Clean，重新编译仍然会有错。WidgetTypeChooser.java报错，但实质上并不是这个文件出了问题。这也正是ADT-Bundle安装的eclipse没有自己下载的Eclipse好用的表现之一，当出现大量错误时，前者会乱报错。这时gen文件夹下com.android.gallery3d下的R文件已经生成。整个工程的错误在包com.android.camera.ui下的各个java文件中，这些java文件都导入了com.android.camera.R,但实质上和camera相关的资源ID都被整合到gen文件夹下的com.android.gallery3d.R文件中了。也即本来应该是camera的R文件整合到gallery的R文件中去了，com.android.camera.R这个文件根本没有生成。因此凡是import com.android.camera.R;有这句话的地方一定会报错，奇怪的是eclipse还显示不出来。用import com.android.gallery3d.R;来代替这句话即可。

10、      在修改了com.android.camera.ui包下的各个java文件后，对com.android.camera包下的java文件也要进行修改，凡是引用了R的地方都会报错，但eclipse可能显示不出来。一定要保证com.android.camera.ui包下凡是引用R文件的地方都要导入Gallery3d.R包。

11、      在编译的时候会将错误显示到WidgetTypeChooser.java中，并在下方输出错误为：The project was not built since its build path is incomplete. Cannot find the class file for android.view.CompatibilityInfoHolder. Fix thebuild path then try building this project GalleryUnknownJava Problem。即找不到android.view.CompatibilityInfoHolder，参考http://124.16.139.131:24080/lxr/source/frameworks/base/core/java/android/view/CompatibilityInfoHolder.java?v=android-4.0.4新建包android.view，然后将新建CompatibilityInfoHolder.java。[备注：在有的版本上并没有遇到这个问题，有可能是android4.2将这个类去除了。]

package android.view;

 import android.content.res.CompatibilityInfo;

 /** @hide */
 public class CompatibilityInfoHolder {
     private volatile CompatibilityInfo mCompatInfo = CompatibilityInfo.DEFAULT_COMPATIBILITY_INFO;

     public void set(CompatibilityInfo compatInfo) {
         if (compatInfo != null && (compatInfo.isScalingRequired()
                 || !compatInfo.supportsScreen())) {
             mCompatInfo = compatInfo;
         } else {
             mCompatInfo = CompatibilityInfo.DEFAULT_COMPATIBILITY_INFO;
         }
     }

     public CompatibilityInfo get() {
         return mCompatInfo;
     }

     public CompatibilityInfo getIfNeeded() {
         CompatibilityInfo ci = mCompatInfo;
         if (ci == null || ci  == CompatibilityInfo.DEFAULT_COMPATIBILITY_INFO) {
             return null;
         }
         return ci;
     }
 }

 

12、    再次clean编译会报错：某个函数需要的api版本要大于11，当前最低版本为10.需修改AndroidManifest.xml文件，最低api版本为11，目标版本为17，因为我们的手机是4.2对应级别为17。

13、    再次clean编译会报错：在ImageFilterSharpen.java函数里找不到forEach_root（）函数。通过对源码编译的输出路径out进行搜索，在/out/target/common/obj/APPS/GALLERY2_intermediates/src/com/android/Gallery3d/filtershow/filters文件夹下找到ScriptC_convolve3x3.java一共可以找到3份同名的文件，只有这个路径下的代码有forEach_root(Allocation, Allocation)接口。将此文件复制出来一份，粘贴到com.android.gallery3d.filtershow.filters下，将名字改为MyScriptC_convolve3x3.java，否则会跟gen文件下的文件重名，并在类的构造函数等其他地方更改名字，包名也要改。

/*
 * Copyright (C) 2011-2012 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/*
 * This file is auto-generated. DO NOT MODIFY!
 * The source Renderscript file: packages/apps/Gallery2/src/com/ku/cameragal/filtershow/filters/convolve3x3.rs
 */
package com.android.gallery3d.filtershow.filters;

import android.renderscript.*;
import android.content.res.Resources;

/**
 * @hide
 */
public class MyScriptC_convolve3x3 extends ScriptC {
    private static final String __rs_resource_name = "convolve3x3";
    // Constructor
    public  MyScriptC_convolve3x3(RenderScript rs) {
        this(rs,
             rs.getApplicationContext().getResources(),
             rs.getApplicationContext().getResources().getIdentifier(
                 __rs_resource_name, "raw",
                 rs.getApplicationContext().getPackageName()));
    }

    public  MyScriptC_convolve3x3(RenderScript rs, Resources resources, int id) {
        super(rs, resources, id);
        __I32 = Element.I32(rs);
        __ALLOCATION = Element.ALLOCATION(rs);
        __F32 = Element.F32(rs);
        __U8_4 = Element.U8_4(rs);
    }

    private Element __ALLOCATION;
    private Element __F32;
    private Element __I32;
    private Element __U8_4;
    private FieldPacker __rs_fp_ALLOCATION;
    private FieldPacker __rs_fp_F32;
    private FieldPacker __rs_fp_I32;
    private final static int mExportVarIdx_gWidth = 0;
    private int mExportVar_gWidth;
    public synchronized void set_gWidth(int v) {
        setVar(mExportVarIdx_gWidth, v);
        mExportVar_gWidth = v;
    }

    public int get_gWidth() {
        return mExportVar_gWidth;
    }

    public Script.FieldID getFieldID_gWidth() {
        return createFieldID(mExportVarIdx_gWidth, null);
    }

    private final static int mExportVarIdx_gHeight = 1;
    private int mExportVar_gHeight;
    public synchronized void set_gHeight(int v) {
        setVar(mExportVarIdx_gHeight, v);
        mExportVar_gHeight = v;
    }

    public int get_gHeight() {
        return mExportVar_gHeight;
    }

    public Script.FieldID getFieldID_gHeight() {
        return createFieldID(mExportVarIdx_gHeight, null);
    }

    private final static int mExportVarIdx_gPixels = 2;
    private Allocation mExportVar_gPixels;
    public void bind_gPixels(Allocation v) {
        mExportVar_gPixels = v;
        if (v == null) bindAllocation(null, mExportVarIdx_gPixels);
        else bindAllocation(v, mExportVarIdx_gPixels);
    }

    public Allocation get_gPixels() {
        return mExportVar_gPixels;
    }

    private final static int mExportVarIdx_gIn = 3;
    private Allocation mExportVar_gIn;
    public synchronized void set_gIn(Allocation v) {
        setVar(mExportVarIdx_gIn, v);
        mExportVar_gIn = v;
    }

    public Allocation get_gIn() {
        return mExportVar_gIn;
    }

    public Script.FieldID getFieldID_gIn() {
        return createFieldID(mExportVarIdx_gIn, null);
    }

    private final static int mExportVarIdx_gCoeffs = 4;
    private float[] mExportVar_gCoeffs;
    public synchronized void set_gCoeffs(float[] v) {
        mExportVar_gCoeffs = v;
        FieldPacker fp = new FieldPacker(36);
        for (int ct1 = 0; ct1 < 9; ct1++) {
            fp.addF32(v[ct1]);
        }

        int []__dimArr = new int[1];
        __dimArr[0] = 9;
        setVar(mExportVarIdx_gCoeffs, fp, __F32, __dimArr);
    }

    public float[] get_gCoeffs() {
        return mExportVar_gCoeffs;
    }

    public Script.FieldID getFieldID_gCoeffs() {
        return createFieldID(mExportVarIdx_gCoeffs, null);
    }

    private final static int mExportForEachIdx_root = 0;
    public Script.KernelID getKernelID_root() {
        return createKernelID(mExportForEachIdx_root, 3, null, null);
    }

    public void forEach_root(Allocation ain, Allocation aout) {
        // check ain
        if (!ain.getType().getElement().isCompatible(__U8_4)) {
            throw new RSRuntimeException("Type mismatch with U8_4!");
        }
        // check aout
        if (!aout.getType().getElement().isCompatible(__U8_4)) {
            throw new RSRuntimeException("Type mismatch with U8_4!");
        }
        // Verify dimensions
        Type tIn = ain.getType();
        Type tOut = aout.getType();
        if ((tIn.getCount() != tOut.getCount()) ||
            (tIn.getX() != tOut.getX()) ||
            (tIn.getY() != tOut.getY()) ||
            (tIn.getZ() != tOut.getZ()) ||
            (tIn.hasFaces() != tOut.hasFaces()) ||
            (tIn.hasMipmaps() != tOut.hasMipmaps())) {
            throw new RSRuntimeException("Dimension mismatch between input and output parameters!");
        }
        forEach(mExportForEachIdx_root, ain, aout, null);
    }

}

14、      在ImageFilterSharpen.java中，将ScriptC_convolve3x3 mScript改为MyScriptC_convolve3x3 mScript，并在相应地方同步更改类名。

经过上述步骤，Android4.2源码Gallery2、Camera模块成功导入Eclipse，并能正常编译，稍后会将编译出的apk共享出来。