v4_migrate.md 1.8 KB

V4.0 Ç¨ÒÆÖ¸ÄÏ

1¡¢V3.0 Óë V4.0 ²îÒì

1.1 API ½Ó¿Ú·½Ãæ

1.1.1 ÍêÈ«¼æÈݾɰæ

V4.0 ÔÚÉè¼ÆÊ±£¬ÒѾ­×öµ½½Ó¿ÚÍêÈ«¼æÈݾɰ汾£¬ËùÒÔÈç¹ûÄãµÄÓ¦ÓÃʹÓõÄÊǾɰ汾£¬ÄÇôÎÞÐèÐÞ¸ÄÈκÎÔ´´úÂë¼´¿É×öµ½ÎÞ·ìÇ¨ÒÆ¡£

1.1.2 ÐÂÔö½Ó¿Ú

V4.0 µ×²ã¶ÔÓÚ ENV µÄ´æ´¢Ê¹ÓÃµÄ blob ¸ñʽ£¬ËùÒÔÔö¼ÓÈçÏ blob ²Ù×÷½Ó¿Ú£¬Ìæ´ú V3.0 µÄ»ùÓÚ×Ö·û´®µÄ½Ó¿Ú

  • size_t ef_get_env_blob(const char *key, void *value_buf, size_t buf_len, size_t *value_len)
  • EfErrCode ef_set_env_blob(const char *key, const void *value_buf, size_t buf_len)

1.1.3 ·ÏÆú½Ó¿Ú

ÒÔϽӿÚÔÚ V4.0 ÖÐÈÔÈ»¿ÉÓ㬵«ÒѾ­ÓÉÓÚÖÖÖÖÔ­Òò±»·ÏÆú£¬¿ÉÄܽ«»áÔÚ V5.0 °æ±¾Öб»Õýʽɾ³ý

  • char *ef_get_env(const char *key)

    • ×¢Ò⣺ÓÉÓÚ V4.0 °æ±¾¿ªÊ¼£¬Ôڸú¯ÊýÄÚ²¿¾ßÓл·¾³±äÁ¿µÄ»º³åÇø£¬²»ÔÊÐíÁ¬Ðø¶à´ÎͬʱʹÓøú¯Êý£¬ÀýÈçÈçÏ´úÂ룺
    // ´íÎóµÄʹÓ÷½·¨
    ssid = ef_get_env("ssid");
    password = ef_get_env("password"); // ÓÉÓÚ buf ¹²Óã¬password Óë ssid »á·µ»ØÏàͬµÄ buf µØÖ·
        
    // ½¨Òé¸ÄΪÏÂÃæµÄ·½Ê½
    ssid = strdup(ef_get_env("ssid")); // ¿Ë¡»ñÈ¡»ØÀ´µÄ»·¾³±äÁ¿
    password = strdup(ef_get_env("password"));
        
    // ʹÓÃÍê³Éºó£¬ÊÍ·Å×ÊÔ´
    free(ssid); // Óë strdup ³É¶Ô
    free(password);
    
  • EfErrCode ef_save_env(void)

  • EfErrCode ef_set_and_save_env(const char *key, const char *value)

  • EfErrCode ef_del_and_save_env(const char *key)

  • size_t ef_get_env_write_bytes(void)

2¡¢Ö÷ÒªÐÞ¸ÄÏî

2.1 ÅäÖ÷½Ãæ

  • ɾ³ý EF_ENV_USING_WL_MODE£ºV4.0 Ô­ÉúÖ§³ÖÄ¥ËðÆ½ºâ£¬ÎÞÐè¶îÍ⿪Æô
  • ɾ³ý EF_ENV_USING_PFS_MODE£ºV4.0 ×Ô´øµôµç±£»¤¹¦ÄÜ£¬ÎÞÐè¶îÍ⿪Æô
  • ɾ³ý ENV_USER_SETTING_SIZE£ºV4.0 ÎÞÐè RAM »º´æ
  • Ôö¼Ó EF_WRITE_GRAN £ºÏê¼ûÒÆÖ²Îĵµ

2.2 ½Ó¿Ú¸Ä½ø

  • ½¨ÒéʹÓà ef_get_env_blob ½Ó¿ÚÌæ´ú ef_get_env£¬Ê¹Ó÷½·¨Ïê¼û API Îĵµ
  • V4.0 ÎÞÐè¶îÍâÖ´Ðб£´æ¶¯×÷£¬ËùÒÔʹÓÃÕâЩ½Ó¿ÚµÄ´úÂëÔÚ V4..0 ÎÞÒâÒ壬¿ÉÒÔÒÆ³ý
    • ef_save_env
    • ef_set_and_save_env
    • ef_del_and_save_env