@alita/native NPM

@alitajs/native

Usage

Configure in .umirc.js 或 config/config.ts;

export default {
  appType: 'native',
};

Init native

Initialize Capacitor configuration by providing an app name, app ID, and an optional web directory for the existing web app.

Please configure displayName and packageId in config/config.t|js file.

export default {
  appType: 'native',
  displayName: 'AlitaDemo', // The application's name
  packageId: 'com.example.appname', // The application's App ID;
};

appName (required): The application's name
appID (required): The application's App ID; something like com.example.appname

npx alita native init

Options:

--web-dir <value>: The existing web application to use with initialization, default dist
--all: Add ios and android platform. Add frequently used plugins.

Add platform

Add a native platform project to your app.

npx alita native add <platform>

Inputs:

platform (required): android, ios

Plugins

npx alita native plugins

This command will install frequently used plugins.

Live reload

Within capacitor.config.json, create a server entry then configure the url field using the local web server's IP address and port:

"server": {
  "url": "http://192.168.1.68:8000",
  "cleartext": true
},

Build web

You may need to build the web when you public app

yarn build

Copy assets

Copy the web app build and Capacitor configuration file into the native platform project. Run this each time you make changes to your web app or change a configuration value.

npx alita native copy [<platform>]

Inputs:

platform (optional): android, ios

Update native

Updates the native plugins and dependencies referenced in package.json.

npx alita native update [<platform>]

Inputs:

platform (optional): android, ios

Options:

--deployment: Podfile.lock won't be deleted and pod install will use --deployment option.

Sync project

This command runs copy and then update.

npx alita native sync [options] [<platform>]

Inputs:

platform (optional): android, ios

Options:

--deployment: Podfile.lock won't be deleted and pod install will use --deployment option.

Run project

npx alita native run [options] <platform>

Inputs:

platform (required): android, ios

Options:

--list: Print a list of target devices available to the given platform
--target <id>: Run on a specific target device

FAQ

1、没有 Max 设备能不能运行 ios 项目？

可以，请自行搜索，Window 系统上如何安装双系统。

2、根据文档一直报错，日志中满满的 ruby 日志，这是怎么回事？

上文是建立在你有原生开发环境的基础上的，如果你当前设备没有安装任何的原生开发环境，请先配置你的电脑。比如 Max 需要下载 Xcode （并且需要手动打开一次，需要签署一个协议），安装 cocoapods。

值得注意的是，Max M1 的话，请不要使用 gem 安装 cocoapods，如果你已经使用 sudo gem install cocoapods 安装过 cocoapods ，请使用 sudo gem uninstall cocoapods 卸载后，再使用 brew install cocoapods 安装。