开发 React Native APP —— 从改造官方Demo开始（2）

这部分在android下无效…… ，个人是win，所以后面没有展示效果图，有mac的可以尝试下效果复制代码

1.1 修改 StackNavigator API

需要注意的是 如果页面进入方式为 modal，需要自定义 header，因为默认 header 样式失效，都叠在一块了 。（还没有实际遇到，先mark着）

1.2 页面中调用

/**
 * ScreenSome2/view.js
 * 自定义 header（关闭按钮）
 */
import React from 'react';
import { TouchableHighlight,Text,View } from 'react-native'
import pxToDp from '../../config/pxToDp';

<View>
  <TouchableHighlight
    onPress={() => self.navigation.goBack()}
    underlayColor="transparent"
    style={{
      display: "flex",
      justifyContent: "center",
      marginTop: pxToDp(30),
      width: pxToDp(150),
      height: pxToDp(90),
      backgroundColor: "yellow"
    }}
  >
    <Text style={{ marginLeft: pxToDp(24) }}>关闭</Text>
  </TouchableHighlight>

  <Text style={{ fontSize: pxToDp(36) }}>some2，以 modal 的形式进入</Text>
</View>复制代码

/**
 * ScreenSome2/view.js
 * 自定义 header（关闭按钮）
 */
import React from 'react';
import { TouchableHighlight,Text,View } from 'react-native'
import pxToDp from '../../config/pxToDp';

export default self => (
  <View>
    <TouchableHighlight
      onPress={() => self.navigation.goBack()}
      underlayColor="transparent"
      style={{
        display: "flex",
        justifyContent: "center",
        marginTop: pxToDp(30),
        width: pxToDp(150),
        height: pxToDp(90),
        backgroundColor: "yellow"
      }}
    >
      <Text style={{ marginLeft: pxToDp(24) }}>关闭</Text>
    </TouchableHighlight>

    <Text style={{ fontSize: pxToDp(36) }}>some2，以 modal 的形式进入</Text>
  </View>

);复制代码

为了看起来稍微好看点，加了一点样式，不加也可以。style.js

import { StyleSheet } from 'react-native';

export default StyleSheet.create({
  buttonContainer: {
    margin: 20
  },
});复制代码

别忘了在route里配置新的路由，完整代码如下：

// 引入依赖
import React from 'react';
import { createStackNavigator, createAppContainer } from 'react-navigation'

// 引入页面组件
import ScreenBottomTab from '../screens/ScreenBottomTab';
import ScreenHome from '../screens/ScreenHome';
import ScreenSome1 from '../screens/ScreenSome1';
import ScreenSome2 from '../screens/ScreenSome2';
import ScreenTab1 from '../screens/ScreenTab1';
import ScreenTab2 from '../screens/ScreenTab2';
import ScreenTab3 from '../screens/ScreenTab3';

/**
 * 自定义 StackNavigator，可以选择 screen 进入方式
 * 默认状态为 card，只需要输入对应页面，比如 ..navigate('ScreenSome1')
 * 如果要使某个页面进入方式为 modal 只需要在路径上加上 Modal
 * 比如：..navigate('ScreenSome2Modal')
 */
const StackModalNavigator = (routeConfigs, navigatorConfig) => {
  const CardStackNavigator = createStackNavigator(routeConfigs, navigatorConfig);
  const modalRouteConfig = {};
  const routeNames = Object.keys(routeConfigs);

  for (let i = 0; i < routeNames.length; i++) {
    modalRouteConfig[`${routeNames[i]}Modal`] = routeConfigs[routeNames[i]];
  }

  const ModalStackNavigator = createStackNavigator(
    {
      CardStackNavigator: { screen: CardStackNavigator },
      ...modalRouteConfig,
    },
    {
      // 如果页面进入方式为 modal，需要自定义 header（默认 header 样式失效，都叠在一块了）
      mode: 'modal',
      headerMode: 'none',
    },
  );

  return ModalStackNavigator;
};


// 配置路由
const AppNavigator = StackModalNavigator({
  ScreenBottomTab: ScreenBottomTab,
  //下面几个配置的是测试Navigator不同使用场景用，只需要tab的话，只要ScreenBottomTab: ScreenBottomTab即可
  ScreenHome: ScreenHome, 
  ScreenSome1: ScreenSome1,
  ScreenSome2: ScreenSome2,
  ScreenTab1: ScreenTab1,
  ScreenTab2: ScreenTab2,
  ScreenTab3: ScreenTab3,
});
const App = createAppContainer(AppNavigator)
export default App
复制代码

this.props.navigation有很多方法，demo中(ScreenHome,ScreenSome1)只用到.navigate，.push，.goBack，具体可参考https://reactnavigation.org/docs/zh-Hans/navigation-prop.html

二 自适应

自适应主要包括两方面：尺寸根据屏幕大小自适应，包括 fontSize ， width 等；图片分辨率根据屏幕分辨率自适应，也就常说的二倍图、三倍图等。

2.1 尺寸自适应

copy自@L小庸的代码片段

尺寸自适应的原理是通过获取手机屏幕的宽度，尺寸做相应比例的调整，为此封装了一个 工具 函数，放在了 config/pxToDp.js 中。

• config/pxToDp.js 尺寸转换的工具函数

1）编写自适应尺寸工具函数

因为所有涉及尺寸的数据都要转换（ fontSize ， width 等），所以对转换后的数据要做处理，保证：1.大于等于 1 的数字向上取整；2.小于 1 的数字，如果是 ios 平台统一设为 0.5；如果是安卓平台统一设为 1（因为安卓平台分辨率千差万别万别，低分辨率的屏幕显示 0.5 的尺寸会有锯齿状）。工具函数完整代码如下：

/**
 * 自适应布局
 * @param uiElementPx: ui给的原始尺寸
 */
import { Dimensions, Platform } from 'react-native';

// app 只有竖屏模式，所以可以只获取一次 width
const deviceWidthDp = Dimensions.get('window').width;

// UI 默认给图是 750
const uiWidthPx = 750;

function pxToDp(uiElementPx) {
  const transferNumb = uiElementPx * deviceWidthDp / uiWidthPx;

  if (transferNumb >= 1) {
    // 避免出现循环小数
    return Math.ceil(transferNumb);
  } else if (Platform.OS === 'android') {
    // 如果是安卓，最小为1，避免边框出现锯齿
    return 1;
  }
  return 0.5;
}

export default pxToDp;
复制代码

# 一张图片提供 3个尺寸

test.png # 尺寸 40 x 40
test@2x.png # 尺寸 80 x 80
test@3x.png # 尺寸 120 x 120复制代码

name@nx 是 n (n > 1) 倍图命名规范，React Native 也是根据命名判断图片尺寸的。

/**
 * ScreenTab3/view.js
 */

<Image
  source={require("../../assets/images/test.png")}
  style={{ height: pxToDp(80), width: pxToDp(80) }}
/>复制代码

三 修改桌面图标、App 展示名称，设置启动页

修改桌面图标、App 展示名称相对简单，设置启动页稍微麻烦。

IOS的设置并没有mac去尝试，可参考@L小庸的https://juejin.im/post/5a9602c45188257a7262e3fb尝试，

踩坑： 开发要连真机调试，尤其是涉及原生功能的部分，切记。

3.1 设置桌面图标

因为 App 图标对应多个尺寸，手动改写太麻烦，这个网站可以自动生成MakeAppIcon。

并不是所有尺寸的图片都需要，见下文。

IOS的参考@L小庸的https://juejin.im/post/5a9602c45188257a7262e3fb尝试

<resources>
    <string name="app_name">你的app名称</string>
</resources>
复制代码复制代码

安卓的话，还要修改默认包名（ applicationId ），如果不修改，如果系统监测到当前应用的 applicationId 和已安装的某个应用相同而签名不同，会报错：“签名不一致 该应用可能已被恶意篡改”。

在这个文件中修改包名： yourApp/android/app/build.gradle ：

// ...

defaultConfig {
    applicationId "com.yourAppId"
    // ...
}

// ...复制代码

3.3 设置启动页

这里使用了第三方插件 react-native-splash-screen ，官网教程已经很详细，这里做简要介绍。

• 项目中安装依赖

1）下载依赖

yarn add react-native-splash-screen复制代码

2）添加到项目中

react-native link react-native-splash-screen复制代码

3）在 React Native 配置

这里指的是设置启动页什么时候消失，下面的代码是首页加载完 5s 后启动页消失。

export default class ScreenHome extends Component {
  // ...other code
  componentDidMount() {
    // 隐藏启动页，如果不设置消失时间，在组件加载完启动页自动隐藏
    setTimeout(() => {
      SplashScreen.hide();
    }, 5000);
  }
  // ...other code
}复制代码

• iOS 设置参考@L小庸的https://juejin.im/post/5a9602c45188257a7262e3fb尝试
• 安卓配置

1）更新 MainActivity.java(yourApp/android/app/src/main/java/com/yourApp/MainActivity.java) ：            

import android.os.Bundle; // here
import com.facebook.react.ReactActivity;
// react-native-splash-screen >= 0.3.1
import org.devio.rn.splashscreen.SplashScreen; // here
// react-native-splash-screen < 0.3.1
import com.cboy.rn.splashscreen.SplashScreen; // here

public class MainActivity extends ReactActivity {
   @Override
    protected void onCreate(Bundle savedInstanceState) {
        SplashScreen.show(this);  // here
        super.onCreate(savedInstanceState);
    }
    // ...other code
}复制代码

2）新建 launch_screen.xml

在 app/src/main/res/layout 中创建 launch_screen.xml （如果没有 layout 目录，新建），内容如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/launch_screen">
</LinearLayout>复制代码

3）准备不同尺寸的启动页图片并放到项目中

安卓是通过文件夹路径寻找启动页面的，所以，多张尺寸的启动页名称相同，都为 launch_screen.png ，但要放在不同文件夹中，文件夹放置目录为 yourApp/android/app/src/main/res/ ，名称及对应放置的图片尺寸如下：

文件必须是 png 格式的图片,开始随便找了一张图片，结果打包各种报错 ，命名需对应尺寸

<resources>
    <!-- Base application theme. -->
    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <!-- Customize your theme here. -->
        <!--设置透明背景-->
        <item name="android:windowIsTranslucent">true</item>
    </style>
</resources>复制代码

5） 解决安卓 6.0，7.0 安装配置完成后出现闪退 ，参考下面设置：（copy，踩坑填坑）

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <!-- this is referenced by react-native-splash-screen and will throw an error if not defined.  its value does nothing, just here to avoid a runtime error. -->
    <color name="primary_dark">#000000</color>
</resources>复制代码

3.4 最终效果图

设置完桌面图标、修改 APP 展示名称及设置启动页之后的效果图如下：

demo里后续添加了自己练习的部分，所以效果图和代码稍有差别，需要的只用care文章里的步骤就好

四 打包发布

4.1 安卓打包发布

• 生成签名

keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

MYAPP_RELEASE_STORE_FILE=my-release-key.keystore
MYAPP_RELEASE_KEY_ALIAS=my-key-alias
MYAPP_RELEASE_STORE_PASSWORD=*****
MYAPP_RELEASE_KEY_PASSWORD=*****复制代码

3）添加签名信息到 app 的 gradle 配置中

编辑文件 yourApp/android/app/build.gradle 加入签名信息

android {
    ...
    defaultConfig { ... }
    signingConfigs {
        release {
            if (project.hasProperty('MYAPP_RELEASE_STORE_FILE')) {
                storeFile file(MYAPP_RELEASE_STORE_FILE)
                storePassword MYAPP_RELEASE_STORE_PASSWORD
                keyAlias MYAPP_RELEASE_KEY_ALIAS
                keyPassword MYAPP_RELEASE_KEY_PASSWORD
            }
        }
    }
    buildTypes {
        release {
            ...
            signingConfig signingConfigs.release
        }
    }
}复制代码

• 打包

在终端输入下面命令

cd android && ./gradlew assembleRelease复制代码

classpath 'com.android.tools.build:gradle:3.0.0'
distributionUrl=https://services.gradle.org/distributions/gradle-4.1-all.zip
android.enableAapt2=false复制代码