ionic + angular开发篇之踩坑集

小灰灰 2022-05-21 13:40 298阅读 0赞

# 一、API篇 #

## 1.接口无法访问 ##

百度地图、自定义API无法访问，远程调试结果显示404   
原因是cordova 5.x的版本增加了“Content-Security-Policy”用于解决安全访问的问题。默认情况下，只能访问本机资源。

解决方法：   
1.添加白名单插件，在项目目录下执行

ionic plugin add cordova-plugin-whitelist

2.在index.html头部增加

## 2.无法跨域访问 ##

服务端设置(PHP)

header('Access-Control-Allow-Origin: *');
    header('Access-Control-Allow-Credentials:true');

## 3.POST请求提交自动变成Options请求 ##

当我们使用浏览器调试的时候，发现POST请求会自动变成Options请求，然后调用任意接口都提示不能跨域访问，即使服务端已经设置允许跨域访问。

解决方法：

.config(function ( $stateProvider, $urlRouterProvider, $ionicConfigProvider, $httpProvider) { 
        // Use x-www-form-urlencoded Content-Type
        $httpProvider.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded;charset=utf-8';
        }

这个问题只出现在浏览器调试中，实际在手机里运行不需要这个配置。

## 4. ionic 里使用 iframe 可能遇到的问题 ##

无法访问外部url的问题–两个步骤解决：   
iframe的src属性用ng-src属性替代，并指明绑定对象： ng-src=”\{ \{targetUrl\}\}”   
在controller里，调用sce:sce:scope.targetUrl = $sce.trustAsResourceUrl(url)

高度无法最大化的问题–两个步骤解决：   
ion-content 属性里添加 scroll=”true” overflow-scroll=”true”，参考   
[iframe content scroll issue \#1151][iframe content scroll issue _1151]

iframe的style里添加 min-height: 100%，参考   
[Fill content container][]

## Ionic与第三方的Wap网页交互 ##

采用Windows.Open的方法，打开一个浏览器，不带地址栏，全屏的窗口，显示第三方的WebApp页面。   
代码如下：

// event类型有以下几种类型
    // loadstart - 开始加载
    // loadstop - 完成加载
    // loaderror - 加载出错
    // exit - 窗口退出
    var ref = window.open(encodeURI(url), '_blank','location=no');
     ref.addEventListener('loadstart', function(event) {
         if (event.url.match("mobile/close")) {
             ref.close();
         }
     });

当浏览器内的url地址包含 mobile/close页面的时候，就会关闭当前的浏览器。   
具体可以参考   
[http://cordova.apache.org/docs/en/3.0.0/cordova/inappbrowser/inappbrowser.html][http_cordova.apache.org_docs_en_3.0.0_cordova_inappbrowser_inappbrowser.html]

# 二、调试篇 #

## 1.本地调试 ##

电脑上本地调试，用ionic serve即可在浏览器中调试

## 2.远程调试 ##

1.在手机上运行debug版软件，在电脑上调试程序   
2.在启动手机上的APP后，在谷歌浏览器（其实360也行）上输入chrome://inspect/\#devices，可以进入调试界面（如果出不来，请翻墙）   
![这里写图片描述][20150907172244845]   
3.单击inspect，可以进入当前显示的页面调试，调试方法和和在浏览器上一致。

远程调试可以快速定位，在浏览器上没有发现的问题，方便调试手机API接口

# 三、应用篇 #

## 1.导航置底设置 ##

好不容易按教程一步步建立了tabs样例工程，却发现安卓机上这个tab导航在顶部，浏览器和ios这个导航在顶部。   
解决方案：   
在app.js里添加以下代码

.config(function ($stateProvider, $urlRouterProvider, $ionicConfigProvider) { 
        $ionicConfigProvider.platform.ios.tabs.style('standard');
        $ionicConfigProvider.platform.ios.tabs.position('bottom');
        $ionicConfigProvider.platform.android.tabs.style('standard');
        $ionicConfigProvider.platform.android.tabs.position('bottom');
        $ionicConfigProvider.platform.ios.navBar.alignTitle('center');
        $ionicConfigProvider.platform.android.navBar.alignTitle('center');
        $ionicConfigProvider.platform.ios.backButton.previousTitleText('').icon('ion-ios-arrow-thin-left');
        $ionicConfigProvider.platform.android.backButton.previousTitleText('').icon('ion-android-arrow-back');
        $ionicConfigProvider.platform.ios.views.transition('ios');
        $ionicConfigProvider.platform.android.views.transition('android');

## 2.百度地图开发 ##

### 坑1：使用了插件angular-BMap ###

使用了插件angular-BMap

这个插件功能并不完善，好多功能都没有，如果要使用需要继续开发（如果你有时间，有兴趣，有能力可以fork后继续开发）

### 坑2：使用了百度地图实例代码，地图不显示 ###

var map = new BMap.Map("container");          // 创建地图实例 
    var point = new BMap.Point(116.404, 39.915);  // 创建点坐标 
    map.centerAndZoom(point, 15);                 // 初始化地图，设置中心点坐标和地图级别

其实只是在模拟手机的浏览器下不显示，在浏览器上不要选择任何手机型号，就能显示，而实际我在自己的手机上build后，也是能正常显示的。具体原因没有深究，如果有知道的朋友欢迎来信。

### 坑3：GPS位置偏移 ###

使用$cordovaGeolocation.getCurrentPosition()获得的坐标，在百度地图上位置偏移。原因是GPS坐标和百度地图坐标并不是完全对应的，需要使用百度地图提供的GPS坐标转换接口进行转换

### 坑4 infowindow里面的a链接只能跳转一次 ###

BMap中创建的infowindow，如果里面带有a链接，第一次跳转后，第二次进去就无法跳转了。这个问题目前不知道怎么解决，如果有人知道请告诉我，谢谢。

# 四、常见错误 #

## 1. 编译错误 ##

### a. Execution failed for task ‘:app:mergeDebugResources’ OR Execution failed for task ‘:Application:processDebugResources’ ###

> com.android.ide.common.process.ProcessException: org.gradle.process.internal.ExecException: Process 'command 'C:\Users\admin\AppData\Local\Android\sdk\build-tools\23.0.3\aapt.exe'' finished with non-zero exit value 1
    
    * Try:
    Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.
    
    Error: Error code 1 for command: cmd with args: /s,/c,"D:\myApp\platforms\android\gradlew cdvBuildDebug -b D:\myApp\platforms\android\build.gradle -Dorg.gradle.daemon=true -Pandroid.useDeprecatedNdk=true"

检查一下，看看是不是哪里的资源文件命名不规范，文件名称不规范就可能导致该问题.   
或者执行以下命令：

C:\>D:\myApp\platforms\android\gradlew cdvBuildDebug -b D:\myApp\platforms\android\build.gradle -D org.gradle.daemon=true -Pandroid.useDeprecatedNdk=true" --info --debug > d:\debug.info

然后从d:\\debug.info文件中查找详细的错误信息。

### 2.ionic build android 没有反应 ###

检首次Build的时候 android平台，会安装gradle工具，但是因为网络的问题，很可能安装的非常的慢到无法忍受。那么很有可能是因为你的Gradle的工具会去下载platforms/android/cordova和CordovaLib的maven的库，这个时候需要修改build.gradle文件的repositories库中，mavenCentral()修改成为阿里云的库

repositories {
            flatDir {
                dirs 'libs'
            }
            //mavenCentral()
            maven { url "http://maven.aliyun.com/nexus/content/groups/public" }
        }

# 常识与技巧篇 #

1.  list 有延迟，可以在ion-content处使用 overflow-scroll=”true”尝试
2.  在上用ng-click上是没效果的
3.  标签内的事件会在整个label内被触发，点哪都触发
4.  快捷修改背景色style=”background-color: \#212326;”
5.  能用ng-if就用ng-if,ng-if的效率比ng-show和ng-hide高
6.  直接在ion-list中的ion-item中并不能触发ng-click事件，可以在item中的元素上再套一层div
7.  可以用ng-class=”\{‘important’: post.important\}”配合css 根据列表元素显示不同的效果
8.  获取日期用filter，varpostdate=filter，varpostdate=filter(‘date’)(date, ‘yyyy-MM-dd HH:mm:ss’);
9.  列表中的元素不能写成 id : 4，应写成 id : “4”,注意在创建id变量的时候也需要转成string,如：   
    `var id = InfoListService.getListLength()+1+""; `  
    
    
    1.  使用log进行log输出,为什么用log进行log输出,为什么用log而不是console.log呢？可以看看这个
    2.  在安卓上的体验比较差，动画有延迟？可以试试ionic集成的crosswalk
    3.  controllers和services 的文件名可能会重合，但是他们意义差不多，可以将controllers中的文件名小写，对应的services中的文件名大写进行区分,或者加后缀xxxControler,xxxService
    4.  安装cordova插件的时候用ionic plugin add …的方式添加，这样会在package.json中添加这个插件的条目，如果有人clone了你的项目想在本地运行，可以用ionic state restore它会根据cordovaPlugins条目安装对应的插件。如果直接用cordova plugin add 安装则不会更新package.json。
    5.  上传base64编码的时候如果提示413错误，是因为文件过大导致的，可以在nodejs中设置bodyparser的文件限制:

var bodyParser = require('body-parser');
    app.use(bodyParser.json({limit: '50mb'}));
    app.use(bodyParser.urlencoded({limit: '50mb', extended: true}));

1.  img 中 base64编码的图片无法显示？在源码中发现angular添加了unsafe标签？需要在白名单中添加data:image

1.  有时候pm2运行有问题，重启一下即可

# Q&A篇 #

Q: 在 iOS 下使用 cordova-plugin-file-transfer 下载中文名文件失败，提示 Could not create target file   
A: encodeURI(“包含霸气的中文文件名的 URI”)

Q: 应用需要存储较大量数据，原始格式是 json ，存 sqlite 数据库嫌麻烦。   
A: lokiJS ，类 mongodb 的 js 内存数据库，配合为 ionic 打造的插件做持久化存储。

Q: 不同 Android 手机上出现字体错位之类的奇怪问题。   
A: 使用 Crosswalk 消除不同安卓机上 WebView 的差别，顺便还能提升应用性能。

Q: 在实机上使用 livereload 功能时出现空白、连接失败等情况。   
A: 实机上的 livereload 本质是用手机访问电脑上的网站，检查手机和电脑之间的网络连接是否通畅。

Q: gitignore 默认排除了 plugins 文件夹，团队其他人 clone 了项目后缺少插件，一个一个装太麻烦。   
A: `ionic platform add/remove xxx 以及 ionic plugin add/remove xxx` 的时候，Ionic CLI 都在 package.json 中保存了项目的状态。clone 完后可以使用 `ionic state restore` 命令快速恢复

Q: 在哪里查看 Ionic 带的所有图标？   
A: [http://ionicons.com][http_ionicons.com]

Q: 在 `ionic platform add xxx` 时卡住   
A: 挂 VPN ，或者丢着睡一觉（不确定是不是网络原因，就遇过两次没深究）

Q: tel:xxxxx sms:xxxxxx mailto:xxxxxx geo:xxxxxx 一类的链接不能唤起其他应用。   
A: 在 config.xml 中加入：

Q: 跟上 Q 一样，加了还 TM 不行！   
A: 再在 config.xml 中加入：

<allow-intent href="tel:*"/>
    <allow-intent href="sms:*"/>
    <allow-intent href="mailto:*"/>
    <allow-intent href="geo:*"/>

Q: Android 中调用其他应用打开 applicationDirectory 下的文件时提示路径不存在， iOS 可以。   
A: 两个系统策略不一样， Android 中有这个需求简单的办法是参考该页中的 Android 文件系统布局，把文件从 Private 目录复制到 Public 目录下再做操作。

Q: 对 Android 进行远程调试。   
A: 打开 Chrome ，地址栏输入 chrome://inspect

Q: 对 iOS 进行远程调试   
A: 打开 Safari -> 开发 -> 手机名 -> 应用名

Q: Ionic 的 Modal 是什么鬼？不能给它设定状态么？！   
A: 超级弱逼的模态框，因为 uirouter 的限制，给它转状态非常不方便。确定只需要一个页面就能完成的操作才用他。下一 Q 提供个解决办法。

Q: 替代 Modal 的方案   
A: 在 $state.go 前记录下当前的 view ，然后禁止下一个 view 记录 backView ，就不会显示后退按钮（ Android 硬件后退也不行 ）。在需要关闭时，后来加入导航栈的任意 view 中设置 backView 为记录下来的 view ，然后 back 。

// go 的时候
    var backHistoryId = $ionicHistory.currentHistoryId();
    var backViewId = $ionicHistory.currentView().viewId;
    $ionicHistory.nextViewOptions({
      disableBack: true,
      disableAnimate: true
    });
    $state.go('my-awesome-modal', {backViewId: backViewId});
    
    // back 的时候
    var backHistoryId = $ionicHistory.currentHistoryId();
    var backView = $ionicHistory.viewHistory().histories[backHistoryId].stack.filter(function (v) { 
      return v.stateId === $stateParams.backViewId;
    })[0];
    $ionicHistory.backView(backView);
    $ionicHistory.goBack();

Q: ionic serve 或在实机调试时开启了 livereload 功能时的跨域问题   
A:道理还是因为这两种状态下， APP 实际是在访问电脑上的一个网站，任何指向其他地方的链接都是跨域。实机不开 livereload 则不存在这个问题。   
简单的方法就是用实机调试且不开 livereload 。   
复杂点的比如设置 Ionic 自带的代理服务器，参考链接。需要详细了解这个问题也可以看一遍。

Q: 如何在某个界面中去掉导航栏?   
A: 如果某个界面上不想要导航栏，可以简单地在最顶端的标签中添加hide-nav-bar=”true”

如何在ionic中加载本地图片?   
A: 对于css文件夹中的样式文件中如果要调用本地的图片的话,从该css文件所在的文件夹开始算,例如www/css/style.css要加../,否则在浏览器中可以正常显示，在设备上不行，结构如下所示：

.login-page { background:url(../img/signup_bg.png); background-size: cover; background-repeat: no-repeat; }

但是对于在页面中定义的图片路径，从www路径开始算,否则浏览器中可显示，但设备上不行,img文件夹和index.html在一级,如：

Q: 如何在ionic中嵌入网页代码?   
A: 使用ng-bind-html这个类,不过它会过滤原始html的标签，我们可以引入sce模块，用sce模块，用sce.trustAsHtml()方法信任我们获取的网页

Q: 如何将template加载到某个tab或某个sidemenu项目下?   
A:`<ion-nav-view name="menuContent">`可以指定name，然后在子状态中使用该name，ionic就知道该把该状态的template渲染到哪边了。例如：

// signup page
     .state('auth.signup', {
       url: '/signup',
       views: {
           'auth-signup': {
               templateUrl: 'templates/auth-signup.html',
               controller: 'SignUpCtrl'
           }
       }
     })

另有一个tabs中声明该auth-signup:

<ion-tab title="Sign Up" icon-on="ion-ios-personadd"
       icon-off="ion-ios-personadd-outline" href="#/auth/signup">
       <ion-nav-view name="auth-signup"></ion-nav-view>
    </ion-tab>

Q: 运行serve命令时ionic报错?   
A:

ionic $ An uncaught exception occured and has been reported to Ionic

看看你是不还有一个终端在运行着serve呢？

Q: 用docker跑ionic的时候，不能把地址绑定到0.0.0.0怎么处理?   
A:可以用ionic serve -all的方法解决

Q: 加载页面的时候会看到双括号一闪而过？   
A: `angularjs`在使用双括号的时候，第一个加载的页面，也就是应用中的index.html,其未被渲染好的模版可能会被用户看到。用ng-bind就不会遇到这个问题。造成这种现象的原因是，浏览器需要首先加载HTML页面，渲染它，然后Angular才有机会把它解释成你期望看到的内容。不过好消息是，在大多数的模版中你依然可以使用双括号.但是对于index.html页面中的数据绑定操作，建议使用`ng-bind`。   
`ng-bind`使用方式如下: `<p ng-bind="greeting"></p>`

Q: 更新了数据，如何让界面更新呢？   
A: 可以用广播，注意broadcast和broadcast和emit的区别

Q: 如何实现IonicView中card上面有一列分割线的效果?   
A: 在css里定义

#info-up { border-top: 4px solid #f06336; }

Q: controller.js和service.js文件越来越大怎么办?   
A:所有的控制器不必都放在controllers.js这一个文件中，可以新建controllers文件夹，   
然后把每个controller都建一个.js文件，同理services和utils等都是.但注意要在index.html中head部分声明.但是为了避免他们相互覆盖，第一个加载的js中模块中要加\[…\],其他都不需要。如：

// File : /js/directives/mainDirective.js
    angular.module('app.directives',[]);
    
    // File : /js/directives/myGreatDirective.js
    angular.module('app.directives')  
        .directive('myGreatDirective', function(){
            return {
                //...
            }
        });
    
    // File : /js/directives/myBetterDirective.js
    angular.module('app.directives')  
        .directive('myBetterDirective', function(){
            return {
                //...
            }
        });
    
    ...

看[angularjs-code-organization][]了解更多,嗯这篇文章写的还不是best practice，因为你还得记着自己把\[\]写到那个模块里了，统一地写在app.js中即可，在app.js最下面加上类似：

angular.module('fcws.controllers',['ionic', 'fcws.services']);
    angular.module('fcws.services', []);

可以达到和上面一样的效果，而且可以统一管理.

Q: 如何寻找优秀的范例代码?   
A:目前有些ionic 的app没有进行代码混淆，至少ionic官方的ionic view没有进行代码混淆，下载他们的app，文件名改成zip，解压，所有的 www文件都在assets文件夹中，相当于开源了有木有，看看那些最优秀的practice。看中哪些优秀的app，下下来,如何在googleplay上下载？把googleplay应用的地址贴到[apps.evozi][]中。

Q: 如何显示相对时间？   
A:如几分钟前，几天前等,可以用[momentjs][]，看[这篇教程][Link 1]

Q:发布应用的时候如果遇到翻译错误即MissingTranslation怎么办?   
A:暂时的解决方法是，不进行翻译校正, 在 /platforms/android/build.gradle 中的android \{\}节中加入:

lintOptions {
        disable 'MissingTranslation'
        disable 'ExtraTranslation'
    }

Q: 如何在列表右下方添加时间等信息?   
A:`span`可以用来将时间之类的附加信息显示到列表右边,如下面会将创建时间显示在name的右边:

<ion-item class="item item-avatar-left " ng-repeat="message in messages"> <img src="../../img/commander.jpg"> <span class="item-note">{ { message.create_at}}</span> <h2 >{ { message.name}}</h2> <p > { { message.content}}</p> </ion-item >

Q:如何回到上一页面?   
A:用`$ionicHistory`这个模块,引入该模块后使用`goBack([backCount])`，backCount指定回去多少个页面（-1代表回去一个页面），默认为-1

Q:如何关闭应用?   
A:

ionic.Platform.exitApp();

Q: 在安卓设备上如何让title居中?   
A: 在headerbar中添加align-title=”center”,如:

<ion-header-bar class="bar-positive" align-title="center"> <h1 class="title">{ { username}}</h1> </ion-header-bar>

不过这个设置对ion-view无效，亲测，如果要统一让所有navbar上的title居中(包括上面的headerbar)，可以在config里设置,如:

.config(function($stateProvider, $urlRouterProvider,$ionicConfigProvider) {
      $ionicConfigProvider.navBar.alignTitle('center');
      ...

如果要让某一个view title居中，可以用ionicNavBarDelegate，参考\[ionic官方文档\](http://ionicframework.com/docs/api/service/ionicNavBarDelegate，参考\[ionic官方文档\](http://ionicframework.com/docs/api/service/ionicNavBarDelegate/)

Q: 如何让在sidemenu中的headerbar能够显示头像等其他信息?   
A: 解决方案是去掉headerbar,添加一个avatar到sidemenu content中，如:

<ion-side-menu side="left"> <ion-content class="bar-positive"> <ion-list> <ion-item class="item item-avatar item-positive" href="#"> <img src="img/commander.jpg"> <h2 class=" light"> <i class="icon ion-ios-star"></i>{ { title}} </h2> <a>{ { username}}</a> </ion-item>

Q: ionic的subheader挡住了内容区域怎么办?   
A: 解决方案是给加类has-subheader,同理也可以加has-header。如下:

<ion-content class="has-header has-subheader">

Q:对于需要添加数据的list，在添加数据后页面不能及时刷新造成卡顿怎么办?   
A:可以使用`$ionicScrollDelegate.resize();`在添加数据后手动进行重新刷新,记得添加依赖

Q:ionic如何处理回退按钮？例如询问用户是否真的要退出应用   
A:可以在app.js的.run方法中增加对硬件回退按钮的注册处理,这里我在大部分页面都想注册该事件，除去有二级历史页面的我单独判断了下，注意增加依赖。

$ionicPlatform.registerBackButtonAction(function(e) { 
        var current_state_name = $state.current.name;
        if(current_state_name !== 'sidemenu.post'
         && current_state_name !== 'sidemenu.contact_town' &&
        current_state_name !== 'sidemenu.contact_people'){
            $ionicPopup.confirm({
                title: '退出应用',
                template: '您确定要退出xxxx吗?'
            }).then(function (res) { 
                if (res) {
                    //ionic.Platform.exitApp();
                    navigator.app.exitApp();
                } else {
                    console.log('You are not sure');
                }
            });
            e.preventDefault();
            return false;
        }else{
            navigator.app.backHistory();
        }
    },100);

Q:ionic如何实现对每个请求都添加认证信息或认证失败自动重新登录?   
A:在应用的注册或者登录部分，不记名token响应了这个请求并且这个token被存储到本地存储中。当你向后端请求一个服务时，你需要把这个token放在头部中。你可以在app.js的.config方法中使用AngularJS的拦截器实现这个。每次请求都会被拦截并且会把认证头部和值放到头部中,同理如果服务器端响应401或403，跳转到重新登录页面.

$httpProvider.interceptors.push(function ($q, $location, User, $rootScope) { 
        return {
            'request': function (config) { 
                config.headers = config.headers || {};
                if (User.getToken()) {
                    config.headers.Authorization = 'Bearer ' + User.getToken();
                }
                return config;
            },
            'responseError': function (response) { 
                if (response.status === 401 || response.status === 403) {
                    //如果之前登陆过
                    if (User.getToken()) {
                        $rootScope.$broadcast('unAuthenticed');
                    }
                }
                return $q.reject(response);
            }
        };
    });

Q:ionic如何实现搜索框内的全部清除按钮?   
A:在label中的input不能嵌入按钮，因为ionic对于label中的tap事件会进行重定向到input上。解决方案是将label替换成span或div。如下面的搜索框，注意ng-model需要是一个对象才能置空,变量不行:

[iframe content scroll issue _1151]: https://github.com/driftyco/ionic/issues/1151
[Fill content container]: http://forum.ionicframework.com/t/fill-content-container/605
[http_cordova.apache.org_docs_en_3.0.0_cordova_inappbrowser_inappbrowser.html]: http://cordova.apache.org/docs/en/3.0.0/cordova/inappbrowser/inappbrowser.html
[20150907172244845]: /images/20220521/6edcc26d9629480bab7447c3b91eb4fc.png
[http_ionicons.com]: http://ionicons.com/
[angularjs-code-organization]: https://calendee.com/2013/12/29/angularjs-code-organization/
[apps.evozi]: https://apps.evozi.com/apk-downloader/
[momentjs]: https://github.com/moment/moment/
[Link 1]: https://scotch.io/tutorials/display-time-relatively-in-angular