一款轻阅读应用ReadIT，记录我的RN躺坑之旅

背景

一款轻阅读应用ReadIT，支持功能：优质文章推送、评论点赞、计划制定、计划闹钟、天气预报、收藏文章、深浅两套主题、多语言切换、极光推送等功能。后续还会继续集成功能。前后端均自主研发，借鉴市面较好的种子工程，目前未上应用市场，文章目前也比较少，后续会持续补充优质文章。

展示效果

read-it.oss-cn-shenzhen.aliyuncs.com/sys/5972ebea149738f80f8ed11aed7dec22.mp4

Github

github.com/xiaobinwu/readIt

技能树

1、客户端（react-native、@react-navigation、react-native第三方库、typescript、mobx、marked等技术）

2、中台后管系统（antd4、react、redux、react-router4、hook等技术）

3、后端程序（koa、mongoDb、jsonwebtoken、ali-oss等技术）

react-devtools调试（安卓模拟器）

1、开发者菜单中选择"Debug JS Remotely"选项
2、自动打开调试页面 http://localhost:8081/debugger-ui（可做断点调试)
3、打开有异常时暂停（Pause On Caught Exceptions）选项，能够获得更好的开发体验
4、设置环境变量ELECTRON_MIRROR='https://npm.taobao.org/mirrors/electron/'，防止下载react-devtool卡住
5、安装react-devtools，package.json配置npm script，执行npm run react-devtools
6、执行adb reverse tcp:8097 tcp:8097
7、目前react-native => 0.61.5，react-devtool => 3.6.3

注意：react-devtools v4 需要 react-native 0.62 或更高版本才能正常工作。一升级就报错，后续跟进

iconfont字体图标使用

1、下载Iconfont字体图标项目，下载至本地，获取iconfont.ttf
2、放至src/assets/fonts目录
3、配置react-native.config.js,如下：

    module.exports = {
        project: {
            ios: {},
            android: {}, // grouped into "project"
        },
        assets: ["./src/assets/fonts/"], // stays the same
    };

4、运行npm run link，将对应iconfont.ttf分别添加至iOS（Info.plist中Fonts provided by application下添加一行iconfont.ttf）、Android（复制至app/src/main/assets/fonts文件夹中，并且app/src/build.gradle添加配置）
5、将iconfont.json复制至src/components/common/iconfont
6、字体图标封装可参考第4步目录相对应组件文件

tsconfig.json配置

1、详细各个配置项解析，可查看tsconfig.json
2、配置paths,结果不起效，需在src目录添加package.json，配置如下

{
  "name": "@app"
}

第三方库

1、autobind-decorator => 自动将方法绑定到类实例，针对babel7需额外配置插件，如下：

    {
      plugins:  ["@babel/plugin-proposal-decorators", { legacy: true }]
    }

2、mobx / mobx-react => 简单、可扩展的状态管理，
3、@react-navigation/bottom-tabs / @react-navigation/native / @react-navigation/stack => 跨平台导航方案
4、react-native-appearance => 在iOS，Android和Web上访问操作系统外观信息。目前支持检测首选配色方案（浅色/深色）
5、react-native-localize => 用于React Native应用本地化的工具箱
6、@react-native-community/async-storage => 简单的、异步的、持久化的 Key-Value 存储系统
7、react-native-actionsheet => 跨平台ActionSheet
8、react-native-webview => WebView,旨在替代内置WebViewom/react-native-webview/react-native-webview)
9、marked => markdown编译器
10、highlight.js => 代码高亮工具
11、react-native-autoheight-webview => React Native的自动高度webview
12、react-native-image-viewing => 图片滑动浏览控件
13、react-native-root-toast => 吐司控件
14、react-native-calendars => 日历
15、jcore-react-native、jpush-react-native => 极光推送
16、react-native-alarm-clock => 闹钟
17、react-native-amap-geolocation => 高德地址服务
18、 react-native-device-info => 获取设备信息
19、 react-native-image-picker => 上传图片
20、react-native-modal-datetime-picker => 时间选择器
21、react-native-picker-select => 下拉框选择器
22、react-native-splash-screen => 应用启动图

第三方库躺坑

如何获取当前天气、未来三天天气？

使用的是和风天气API，需要经纬入参，所以必须先获取位置，需要申请和风天气的appKey。

推送服务

极光推送服务 jcore-react-native、jpush-react-native，需要申请AppKey。

如何获取位置？

Part1，使用react-native-geolocation-service第三方库，获取经纬度进行高德逆地理编码API调用，获取城市，开启google play服务，需要有处理获取位置的服务程序app/services/location（参考react-native-geolocation-service github example），以及修改android/app/src/main/AndroidManifest.xml，添加<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> 安卓添加权限。结果不行，针对google play服务国内不能使用，所以该方案得摒弃掉，对应app/services/location会删除。

图片上传问题

对于react-native-image-picker第三方库， 对于3.1.4版本，minSdkVersion最少要21以上，在使用的react-native 0.61.5下，修改android/build.gradle的minSdkVersion配置

阿里oss aliyun-oss-rn，需要更改aliyun-oss-rn npm包的android/build.gradle（如下配置）,提高SDK版本号，以及修改主项目AndroidManifest.xml,添加android:allowBackup="true",目前使用上仍有问题，于是放弃该方案，改用oss postObject直传方式，，使用sts临时授权、policy、Signature配合上传。

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:1.3.1'
    }
}

apply plugin: 'com.android.library'

android {
    compileSdkVersion 28
    buildToolsVersion '28.0.3'

    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
    }
    lintOptions {
        abortOnError false
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.facebook.react:react-native:+'
    implementation 'com.aliyun.dpa:oss-android-sdk:+'
}
  
  

日历问题

react-native-calendars的Agenda问题如下：
一、国际化切换、主题切换时，日历没有对应切换，对应HACK处理方法，给Agenda组件设置key，强制组件卸载，重新加载
二、Agenda在国际化切换、主题切换、添加日程的时候，会导致Agenda组件内部View组件onLayout重复触发（我是不需要其一直触发），导致this.viewHeight一直发生变化，导致每次动画执行定位不准问题，处理方法，用个变量存储this.viewHeight，示例代码如下：

let VIEW_HEIGHT = 0;

constructor(props) {
    this.viewHeight = VIEW_HEIGHT || windowSize.height;
}

onLayout = event => {
    if (!VIEW_HEIGHT) {
        VIEW_HEIGHT = event.nativeEvent.layout.height;
        this.viewHeight = event.nativeEvent.layout.height;
        this.viewWidth = event.nativeEvent.layout.width;
        this.forceUpdate();
    }
};

三、日程列表改造，只显示当前选中日期的的日程，Agenda组件代码改造如下：

  renderReservations() {
    const reservationListProps = extractComponentProps(ReservationList, this.props);
    let reservations = {};
    const { items } = this.props;
    if (this.props.selected && items[this.props.selected.dateString]) {
      reservations = { [this.props.selected.dateString]: items[this.props.selected.dateString] };
    }
    console.log(this.props.selected, '选中的时间');

    return (
      <ReservationList
        {...reservationListProps}
        ref={c => (this.list = c)}
        reservations={reservations}
        selectedDay={this.state.selectedDay}
        topDay={this.state.topDay}
        onDayChange={this.onDayChange}
        onScroll={() => {}}
      />
    );
  }

闹钟问题

react-native-alarm-clock,目前yarn、npm均不能下载1.0.0，只能将2.0.0版本下载至本地，替换node_moudules中的对应npm包，功能使用还未考证，仍有问题。

选择下拉框问题

react-native-picker-select，报错信息 "RNCAndroidDialogPicker" was not found in the UIManager，参考[Issues] github.com/lawnstarter/react-native-picker-select/issues/402 ，解决办法，降级@react-native-picker/picker 至 1.8.3

打包 APK 问题

管理员CMD

#keytool -genkey -dname "CN=wushaobin,OU=个人,O=个人,L=深圳,ST=广东,C=CN" -alias test -keyalg RSA -validity 400000 -keystore test.keystore  
#keytool -importkeystore -srckeystore test.keystore -destkeystore test.keystore -deststoretype pkcs12  
#keytool -list -v -keystore test.keystore -storepass xxxxxxxxx  
或 keytool -genkeypair -v -keystore test.keystore -alias test -keyalg RSA -keysize 2048 -validity 400000  

app应用启动图

1、下载react-native-splash-screen

2、android/app/src/main/java/com/readit/MainActivity.java，配置如下：

import com.facebook.react.ReactActivity;

+ import org.devio.rn.splashscreen.SplashScreen;
+ import android.os.Bundle;

public class MainActivity extends ReactActivity {

  /**
@@ -12,4 +15,11 @@
  protected String getMainComponentName() {
    return "readIt";
  }

  // 添加下面方法
  + @Override
  + protected void onCreate(Bundle savedInstanceState) {
      + SplashScreen.show(this);  // here
      + super.onCreate(savedInstanceState);
  + }
}

3、android/app/src/main/res/layout/launch_screen.xml配置如下(没有就添加)：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:orientation="vertical">
    <ImageView android:layout_width="match_parent" android:layout_height="match_parent" android:class="lazyload" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAANSURBVBhXYzh8+PB/AAffA0nNPuCLAAAAAElFTkSuQmCC" data-original="@drawable/launch_screen" android:scaleType="centerCrop" />
</LinearLayout> 

4、android/app/src/main/res/values/styles.xml配置如下：

    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <!-- Customize your theme here. -->
        <item name="android:textColor">#000000</item>
        + <!--添加这一行-->
        + <item name="android:windowIsTranslucent">true</item>
    </style>

5、使用如下：

import SplashScreen from 'react-native-splash-screen';

...

componentDidMount() {
    SplashScreen.hide();
}

app应用图标问题

替换android/app/src/main/res/mipmap-*文件夹中图标图片

./gradlew assembleRelease失败问题
1、先执行./gradlew clean，卸载上一个debug版本
2、再执行./gradlew assembleRelease，生成release版本

常用指令 ./gradlew clean、./gradlew build

编译错误：The Kotlin Gradle plugin was loaded multiple times in different subprojects, which is not supported and may break the build. 问题解决方案：

./gradlew assembleRelease 编译失败

失败信息： Error: ENOENT: no such file or directory, open ‘F:\Project\reactnative\readIt\android\app\build\generated\sourcemaps\react\release\index.android.bundle.map’

发布版本时，删除build/debug.apk，执行./gradlew clean