Why is there no uniapp startup page on the real machine?

With the development of mobile Internet, APP has become an indispensable part of people's lives. As the "face" of the APP, the startup page plays a very important role when the APP is opened. It can not only leave a deep first impression on the user, but also extend the user's stay time. However, when using uniapp to develop APPs, many developers report that the startup page can be displayed normally in the simulator, but cannot be displayed on the real machine. Let's solve this problem together.

1. Confirm whether the image path is correct

First, we need to confirm whether the image path is correct. In uniapp, the images of the startup page are usually saved in the "static" directory. If the image path is configured incorrectly, the startup page cannot be displayed normally. In order to avoid this problem, we can use relative paths or absolute paths for image references.

If we use a relative path to reference an image, we need to add "/" before the image name, indicating that it is relative to the root directory of the current page:

<img  src="/static/imghwm/default1.png"  data-src="/static/image/logo.png"  class="lazy" alt="Why is there no uniapp startup page on the real machine?" >

If we use an absolute path to reference the image, then You need to indicate the complete path, for example:

<img  src="/static/imghwm/default1.png"  data-src="https://www.example.com/image/logo.png"  class="lazy" alt="Why is there no uniapp startup page on the real machine?" >

2. Confirm whether the APP configuration file is correct

If there is no problem with the image path, we need to further confirm whether the APP configuration file is correct. This configuration file is usually saved in "/manifest.json". For example, we need to add the following code to the configuration file to specify the launch page of the APP:

"app": {
  "launch_path": "/pages/index/index",
  "background_color": "#ffffff",
  "navigation_bar_title_text": "uniapp启动页",
  "pages": [
    "pages/index/index"
  ]
}

Among them, the "launch_path" field specifies the launch page path of the APP. Since uniapp is developed based on a small program, the launch The path of the page must be a page path, that is, a path starting with "/pages" and ending with ".vue".

If the "launch_path" field is not added to the configuration file or the path is configured incorrectly, the startup page will not be displayed normally.

3. Confirm whether the APP version has expired

If the above two situations are eliminated and the startup page still cannot be displayed normally, it may be caused by the expired APP version. In uniapp development, if the APP version expires, the startup page will be automatically hidden, resulting in the failure to display properly.

In order to solve this problem, we need to add the following code to the "pages.json" file:

"window":{
  "backgroundTextStyle":"light",
  "navigationBarBackgroundColor": "#fff",
  "navigationBarTitleText": "uniapp启动页",
  "navigationBarTextStyle":"black",
  "onReachBottomDistance":50,
  "enablePullDownRefresh":false,
  "disableScroll":true
},

Among them, the "disableScroll" field indicates whether to prohibit page scrolling. If the value is set to "true" can solve the startup page problem caused by the expired APP version.

In general, if the startup page of uniapp cannot be displayed normally on the real machine, we need to gradually troubleshoot the problem and check the image path, APP configuration file, APP version and other issues to ensure that the startup page can work normally display, leaving a deep first impression and providing users with a better user experience.

The above is the detailed content of Why is there no uniapp startup page on the real machine?. For more information, please follow other related articles on the PHP Chinese website!