Qt on Android：添加分享功能

    前几天（2015-4-15）看到老外的一篇文章，讲如何使用 Qt on Android 来向社交网络分享信息，使用 Qt 提供的 JNI 功能来实现，和我之前写的 QtAndroid 详解系列文章很搭啊，特此翻译过来。

    原文在这里：Sharing with Qt on Android 。是 2014 年 12 月 12 日的文章，恨不相逢未嫁时……Sigh，又胡扯了……还是 Google 强大，可以搜索到好东西。

    原文作者 zagge ，译者foruok（http://blog.csdn.net/foruok），转载请注明出处。

-------------------------------分割线---------------------------------

    我们刚刚发布了 GiraffPanic（一款用Qt & QML 开发的逻辑类益智游戏。译者注：Google Play中可以下载到，收费） 的一个新版本。在这个新版本中，我们给用户提供了相互之间分享解锁密码（code）的机会以方便用户解锁新的关卡（levels）。我们想为不同的设备之间共享密码找一个友好的方式，不需要把密码拷贝粘贴到另外的应用中。尝试了多种途径（都没法正常工作）后，我们发现可以在我们的应用里直接调用 Android 原生的分享菜单。使用这种方式，既保持了我们代码的整洁，又能支持宿主设备所提供的所有共享方式。

    使用那种共享方式，应用不需要任何特别的权限。

    下面是最终效果（图片来自英文原文）：

    你可以在这里（gitorious.org）下载测试应用的示例代码。为了更容易理解，后面展示的代码特意做了简化。

    好啦，我们都要做哪些工作呢？

调用Android原生API的Java类

    ...
    public class ShareIntent
    {
        static public void shareText(String title, String subject, 
                                     String content, QtActivity activity)
        {
            Intent share = new Intent(Intent.ACTION_SEND);
            share.setType("text/plain");

            share.putExtra(Intent.EXTRA_SUBJECT, subject);
            share.putExtra(Intent.EXTRA_TEXT, Html.fromHtml(content).toString());
            share.putExtra(Intent.EXTRA_HTML_TEXT, content);
            activity.startActivity(Intent.createChooser(share, title));
        }
    }
    ...

在pro文件里添加androidextras模块

    ...
    QT += androidextras
    ...

通过 JNI 调用 Java 类的 Qt 类

    ...
    void QtAndroidShare::share(const QString &title, const QString &subject, const QString &content)
    {
        QAndroidJniObject jTitle = QAndroidJniObject::fromString(title);
        QAndroidJniObject jSubject = QAndroidJniObject::fromString(subject);
        QAndroidJniObject jContent = QAndroidJniObject::fromString(content);
        QAndroidJniObject activity = QtAndroid::androidActivity();
        QAndroidJniObject::callStaticMethod<void>(
            "net/exit0/androidshare/ShareIntent",
            "shareText",
            "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;"
                  "Lorg/qtproject/qt5/android/bindings/QtActivity;)V",
            jTitle.object<jstring>(),
            jSubject.object<jstring>(),
            jContent.object<jstring>(),
            activity.object<jobject>()
       );
    }

    QAndroidJniObject是Qt提供的 andoridextras 模块的一部分，简化了使用 JNI 调用 Java 方法的使用。首先我们把 QString 对象转换为 Java 方法需要的 Java String 对象。同时我们也把调用分享意图（Intent）的活动（Activity）对象传递过去。Java 方法 shareText 是静态的，因此我们可以使用 QAndroidJniObject::callStaticMethod<void>() 来调用它。

    callStaticMethod 方法的参数如下：

• className - 代表了你要调用的 Java 方法所属的类，全限定类名
• methodName - 你要调用的 Java 方法名字
• signature - Java 方法的签名
• parameters - 要传递的所有参数

    Bogdan 在  Qt on Android Episode 5 一文中对 Qt 和 JNI 做了很好的概述。（译者注：可以参考我翻译的中文版本——Qt on Android Episode 5（翻译））。

让 AndroidShare 类在 QML 中可用

    为了让 AndroidShare 类在 QML 环境中可见，首先我们像下面这样声明 AndroidShare::share 方法：

    Q_INVOKABLE virtual void share(const QString &title,
                                   const QString &subject,
                                   const QString &content);

    然后我们给 QQmlContext 添加一个 AndroidShare 的对象，作为 QML 上下文的一个属性：

    ...
    QQmlApplicationEngine engine;
    QQmlContext *context = engine.rootContext();

    qmlRegisterType<QtAndroidShare>("QtAndroidShare", 1, 0, "ShareIntent");
    context->setContextProperty("shareIntent", new QtAndroidShare());
    ...

在 QML 中使用

    ...
    Button {
        text: "Press to share"
        onClicked: {
            shareIntent.share(title.text, subject.text, content.text);
        }
    }
    ...

    如你所见，QML 中的调用代码相当简单。

    希望这篇文章对看到的人有所帮助。

    要是你想看看代码在你游戏中运行的效果，可以到 Google Play 中下载。用黑莓的兄弟，看 BlackBerry World ，N9（诺记的手机，是原文作者还在用的手机之一）的粉儿可以点这里下载。

    译者注：Qt 跨平台的好处体现出来啦……

    下面是游戏截图，译者foruok给的了：

    看起来效果还不错哦。

    博主的QtAndroid系列文章列出来供参考：

• QtAndroid详解(5)：JNI调用Android系统功能(2)
  
• QtAndroid详解(4)：JNI调用Android系统功能(1)
  
• QtAndroid详解(3)：startActivity实战Android拍照功能
  
• QtAndroid详解(2)：startActivity和它的小伙伴们
• QtAndroid详解(1)：QAndroidJniObject
• Qt on Android专栏